En este documento se describe la API de telemetría (OTLP), que implementa el protocolo OTLP de OpenTelemetry. Esta API se ha diseñado para usarse con aplicaciones instrumentadas mediante uno de los SDKs de OpenTelemetry.
Por qué deberías usar la API Telemetry
OpenTelemetry es un proyecto de código abierto compatible con Google Cloudque cuenta con ingenieros de Google Cloudpara garantizar la asistencia en la ingesta y visualización de tus datos de traza.
Cuando usas la API 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, los campos se pueden convertir de un tipo de datos específico de OpenTelemetry a un tipo de datos JSON antes de almacenarse. Además, se aplican los límites de la API Telemetry. Estos límites suelen ser más generosos que los de la API 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 datos de traza.
Cuándo usar la API Telemetry
Cuando instrumentes tus aplicaciones para enviar datos de traza a tu Google Cloud proyecto, te recomendamos que hagas una de las siguientes acciones:
- Usa un exportador que escriba OTLP en un Collector, que luego envíe tus datos de seguimiento a la API Telemetry.
- Usa un exportador OTLP en proceso compatible con una biblioteca de OpenTelemetry que envíe datos de telemetría a la API Telemetry. No hay ningún recopilador con esta configuración.
Para obtener información sobre cómo usar la API Telemetry, consulta Migrar del exportador de Cloud Trace al endpoint OTLP.
Dónde ver los datos insertados
Los datos de traza que se ingieren a través de la API Telemetry se pueden ver en la página Explorador de trazas. Para obtener información sobre cómo ver los datos de seguimiento, consulta Buscar y explorar seguimientos.
Autenticación
Los exportadores deben tener autorización para enviar datos a tu Google Cloud proyecto. Por ejemplo, puedes configurar el exportador con tus Google Cloud credenciales predeterminadas de la aplicación (ADC) añadiendo una biblioteca de autenticación de Google específica del lenguaje a tu aplicación. Para obtener más información y código de ejemplo, consulta Configurar la autenticación.
Compatible con los Controles de Servicio de VPC
El servicio de la API Telemetry, cuyo nombre de servicio es telemetry.googleapis.com, es un servicio compatible con Controles de Servicio de VPC. Las restricciones de Controles de Servicio de VPC que crees para el servicio de la API Telemetry solo se aplicarán a ese servicio. Esas restricciones no se aplican a otros servicios, como el servicio cloudtrace.googleapis.com, que también puede ingerir datos de traza.
Para obtener más información, consulta las siguientes secciones: