En este documento, se describe por qué te recomendamos que envíes tus datos de seguimiento a tu Google Cloud proyecto con la API de Telemetry (OTLP), que implementa el protocolo OTLP de OpenTelemetry. También se proporcionan instrucciones para 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 SDK de OpenTelemetry o cuando usas un recopilador de OpenTelemetry.
Te recomendamos la API de Telemetry por el siguiente motivo:
La API proporciona compatibilidad con el ecosistema de OpenTelemetry de código abierto y sus límites suelen ser más generosos que los de la API de Cloud Trace, que es una API propietaria Google Cloud .
Tus datos de seguimiento se almacenan en un formato que suele ser coherente con los archivos proto definidos por el protocolo OTLP de OpenTelemetry. Es posible que algunos campos se conviertan 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 para datos de seguimiento.
Tu instrumentación no depende de un Google Cloud-exportador específico.
Algunas funciones, como Application Monitoring, dependen de la 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 Cloudingenieros que garantizan la compatibilidad para transferir y visualizar tu Google Cloud telemetría.
Google Cloud Observability verifica que la API de Cloud Trace esté habilitada en tu Google Cloud proyecto antes de almacenar cualquier dato de seguimiento. Eso significa que, si inhabilitas la API de Cloud Trace, Google Cloud Observability descartará los datos de seguimiento que envíes a la API de Telemetry.
Prácticas recomendadas
Cuando instrumentes tus aplicaciones para enviar datos de seguimiento a tu Google Cloud proyecto, te recomendamos que hagas una de las siguientes acciones:
- Usa un exportador que escriba OTLP en un recopilador, que luego envíe 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 Google Cloud proyecto. Por ejemplo, para configurar el exportador con tus Google Cloud credenciales predeterminadas de la aplicación (ADC), agrega una biblioteca de autenticación de Google específica para el lenguaje a tu aplicación. Para obtener más información y código de muestra, consulta Configura la autenticación.
Cloud Trace y residencia de datos
Si usas Assured Workloads porque tienes requisitos de residencia de datos o 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 con las páginas Explorador de seguimiento y Observability Analytics. Para obtener más información, consulta lo siguiente: