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
La API Telemetry admite la ingestión de datos de trazas en formato OTLP. Cuando usas la API Telemetry, tus datos se almacenan en formato OTLP sin que se conviertan a un formato propietario, y 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.
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.
Cuándo usar la API Telemetry
Cuando instrumentes tus aplicaciones para enviar datos de traza a tu proyecto deGoogle Cloud , 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 traza a la API Telemetry.
- Usa un exportador OTLP en proceso compatible con una biblioteca de OpenTelemetry que envíe 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.
Los datos de traza insertados a través de la API Telemetry no están disponibles en la página antigua Explorador de trazas. Para obtener más información, consulta Versión antigua de Explorador de trazas: problemas conocidos.
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: