En este documento, se describe la API de Telemetry (OTLP), que implementa el protocolo OTLP de OpenTelemetry. Esta API está diseñada para usarse con aplicaciones instrumentadas con uno de los SDKs de OpenTelemetry.
Por qué deberías usar la API de Telemetry
OpenTelemetry es un proyecto de código abierto compatible con Google Cloudque cuenta con ingenieros Google Cloudpara garantizar la compatibilidad con la transferencia y visualización de tus datos de seguimiento.
Cuando usas la API de Telemetry, tus datos se almacenan en un formato que suele ser coherente con los archivos .proto definidos por el protocolo OTLP de OpenTelemetry. Sin embargo, es posible que los campos se conviertan de un tipo de datos específico de OpenTelemetry a un tipo de datos JSON antes del almacenamiento. Además, se aplican los límites de la API de Telemetry. Estos límites suelen ser más generosos que los de la API de Cloud Trace. Por último, tu instrumentación no depende de un exportador específico de Google Cloud.
Para obtener más información sobre el formato de almacenamiento, consulta Esquema de los datos de registro.
Cuándo usar la API de Telemetry
Cuando instrumentes tus aplicaciones para enviar datos de seguimiento a tu proyecto deGoogle Cloud , te recomendamos que realices una de las siguientes acciones:
- Usa un exportador que escriba OTLP en un Collector, que luego envía tus datos de seguimiento a la API de Telemetry.
- Usa un exportador de OTLP en el proceso compatible con una biblioteca de OpenTelemetry que envíe datos de telemetría a la API de Telemetry. No hay ningún recopilador con esta configuración.
Para obtener información sobre cómo usar la API de Telemetry, consulta Migra del exportador de Cloud Trace al extremo de OTLP.
Dónde ver los datos transferidos
Los datos de seguimiento que se transfieren a través de la API de Telemetry se pueden ver en la página del Explorador de Trace. Para obtener información sobre cómo ver tus datos de seguimiento, consulta Busca y explora seguimientos.
Autenticación
Los exportadores deben estar autorizados para enviar datos a tu proyecto Google Cloud . Por ejemplo, puedes configurar el exportador con tus Google Cloud credenciales predeterminadas de la aplicación (ADC) agregando una biblioteca de Google Auth específica del lenguaje a tu aplicación. Para obtener más información y código de muestra, consulta Configura la autenticación.
Compatibilidad con los Controles del servicio de VPC
El servicio de la API de Telemetry, cuyo nombre de servicio es telemetry.googleapis.com, es un servicio compatible con los Controles del servicio de VPC. Las restricciones de los Controles del servicio de VPC que crees para el servicio de la API de Telemetry solo se aplican a ese servicio. Estas restricciones no se aplican a ningún otro servicio, incluidos aquellos como el servicio de cloudtrace.googleapis.com, que también pueden transferir datos de seguimiento.
Para obtener más información, consulta lo siguiente: