Descripción general de la API de Telemetry (OTLP)

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 SDK de OpenTelemetry.

Por qué debes usar la API de Telemetry

La API de Telemetry admite la transferencia de datos de seguimiento en formato OTLP. Cuando usas la API de Telemetry, tus datos se almacenan en el formato OTLP sin convertirse nunca en un formato propietario, y 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.

OpenTelemetry es un proyecto de código abierto compatible con Google Cloudcon ingenieros Google Cloud en el personal para garantizar la compatibilidad con la transferencia y visualización de tus datos de seguimiento.

Cuándo usar la API de Telemetry

Cuando instrumentes tus aplicaciones para enviar datos de seguimiento a tu proyecto de Google Cloud, te recomendamos que hagas una de las siguientes acciones:

  • Usa un exportador que escriba OTLP en un colector, que luego enviará tus datos de seguimiento a la API de Telemetry.
  • Usa un exportador de OTLP en proceso compatible con una biblioteca de OpenTelemetry que envíe la 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 Cómo migrar 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 Explorador de seguimiento. Para obtener información sobre cómo ver tus datos de seguimiento, consulta Busca y explora seguimientos.

Datos de seguimiento transferidos a través de la página Explorador de seguimiento heredada de la API de Telemetry Para obtener más información, consulta Explorador de seguimiento heredado: Problemas conocidos.

Compatibilidad con los Controles del servicio de VPC

El servicio de la API de Telemetry, cuyo nombre es telemetry.googleapis.com, es un servicio compatible con los Controles del servicio de VPC. Cualquier restricción de los Controles del servicio de VPC que crees para el servicio de la API de Telemetry se aplicará solo a ese servicio. Esas restricciones no se aplican a ningún otro servicio, incluidos aquellos como el servicio cloudtrace.googleapis.com, que también puede transferir datos de seguimiento.

Para obtener más información, consulta lo siguiente: