Ce document explique pourquoi nous vous recommandons d'envoyer vos données de trace à votre projetGoogle Cloud à l'aide de l'API Telemetry (OTLP), qui implémente le protocole OTLP OpenTelemetry. Il fournit également des conseils sur l'instrumentation de vos applications et sur l'emplacement où vous pouvez afficher vos données de trace. Vous pouvez utiliser l'API Telemetry lorsque vous instrumentez vos applications à l'aide de l'un des SDK OpenTelemetry ou lorsque vous utilisez un collecteur OpenTelemetry.
Nous vous recommandons d'utiliser l'API Telemetry pour les raisons suivantes :
L'API est compatible avec l'écosystème Open Source OpenTelemetry et ses limites sont souvent plus généreuses que celles de l'API Cloud Trace, qui est une API Google Cloud propriétaire.
Vos données de trace sont stockées dans un format généralement compatible avec les fichiers proto définis par le protocole OTLP OpenTelemetry. Avant d'être stockés, certains champs peuvent être convertis d'un type de données spécifique à OpenTelemetry en type de données JSON. Pour en savoir plus sur le format de stockage, consultez Schéma des données de trace.
Votre instrumentation ne repose pas sur un exportateur spécifique à Google Cloud.
Certaines fonctionnalités, comme la surveillance des applications, s'appuient sur des informations qui ne sont disponibles que lorsque vous envoyez des données de trace à l'API Telemetry.
OpenTelemetry est un projet Open Source compatible avec Google Cloud. Des ingénieurs Google Cloudsont chargés d'assurer la prise en charge de l'ingestion et de la visualisation de vos données de télémétrie.
Bonnes pratiques
Lorsque vous instrumentez vos applications pour envoyer des données de trace à votre projetGoogle Cloud , nous vous recommandons d'effectuer l'une des opérations suivantes :
- Utilisez un exportateur qui écrit OTLP dans un collecteur, qui envoie ensuite vos données de trace à l'API Telemetry.
- Utilisez un exportateur OTLP intégré compatible avec une bibliothèque OpenTelemetry qui envoie des données de télémétrie à l'API Telemetry. Aucun collecteur ne correspond à cette configuration.
Pour savoir comment utiliser l'API Telemetry, consultez Migrer de l'exportateur Cloud Trace vers le point de terminaison OTLP.
Authentification
Vous devez configurer vos exportateurs avec les identifiants nécessaires pour envoyer les données de trace à votre projet Google Cloud . Par exemple, pour configurer l'exportateur avec vosGoogle Cloud identifiants par défaut de l'application (ADC), ajoutez une bibliothèque d'authentification Google spécifique à la langue à votre application. Pour en savoir plus et obtenir des exemples de code, consultez Configurer l'authentification.
Cloud Trace et résidence des données
Si vous utilisez Assured Workloads parce que vous avez des exigences de résidence des données ou de niveau d'impact 4 (IL4), n'utilisez pas l'API Telemetry pour envoyer des spans de trace à votre projet.
Où consulter les données ingérées ?
Vous pouvez afficher vos données de trace à l'aide des pages Trace Explorer et Analyse de journaux. Pour en savoir plus, consultez les ressources suivantes :