En este documento, se describe por qué recomendamos que envíes tus datos de seguimiento a tu proyecto deGoogle Cloud con la API de Telemetry (OTLP), que implementa el protocolo OTLP de OpenTelemetry. También proporciona orientación sobre cómo instrumentar tus aplicaciones y dónde puedes ver tus datos de seguimiento. Puedes usar la API de Telemetry cuando instrumentas tus aplicaciones con uno de los SDKs de OpenTelemetry o cuando usas un recopilador de OpenTelemetry.
Recomendamos la API de Telemetry por el siguiente motivo:
La API proporciona compatibilidad con el ecosistema de código abierto de OpenTelemetry y sus límites suelen ser más generosos que los de la API de Cloud Trace, que es una API Google Cloud propietaria.
Tus datos de seguimiento se almacenan en un formato que suele ser coherente con los archivos .proto definidos por el protocolo OTLP de OpenTelemetry. Algunos campos se pueden convertir de un tipo de datos específico de OpenTelemetry a un tipo de datos JSON antes del almacenamiento. Para obtener más información sobre el formato de almacenamiento, consulta Esquema de los datos de seguimiento.
Tu instrumentación no depende de un exportador específico de Google Cloud.
Algunas funciones, como la supervisión de aplicaciones, dependen de información que solo está disponible cuando envías datos de seguimiento a 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 telemetría.
Prácticas recomendadas
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 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.
Autenticación
Debes configurar tus exportadores con las credenciales necesarias para enviar datos de seguimiento a tu proyecto de Google Cloud . Por ejemplo, para configurar el exportador con tusGoogle Cloud credenciales predeterminadas de la aplicación (ADC), agrega 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 Cómo configurar la autenticación.
Cloud Trace y residencia de datos
Si usas Assured Workloads porque tienes requisitos de residencia de datos o de nivel de impacto 4 (IL4), no uses la API de Telemetry para enviar intervalos de seguimiento a tu proyecto.
Dónde ver los datos transferidos
Puedes ver tus datos de seguimiento en las páginas Explorador de registros y Análisis de registros. Para obtener más información, consulta lo siguiente: