Ce document décrit l'API Telemetry (OTLP), qui implémente le protocole OTLP OpenTelemetry. Cette API est conçue pour être utilisée avec des applications instrumentées à l'aide de l'un des SDK OpenTelemetry.
Pourquoi utiliser l'API Telemetry ?
L'API Telemetry permet d'ingérer des données de trace au format OTLP. Lorsque vous utilisez l'API Telemetry, vos données sont stockées au format OTLP sans jamais être converties en format propriétaire, et les limites de l'API Telemetry s'appliquent. Ces limites sont souvent plus généreuses que celles de l'API Cloud Trace. Enfin, votre instrumentation ne repose pas sur un exportateur spécifique à Google Cloud.
OpenTelemetry est un projet Open Source compatible avec Google Cloud. Des ingénieurs Google Cloudsont disponibles pour vous aider à ingérer et à visualiser vos données de trace.
Quand utiliser l'API Telemetry ?
Lorsque vous instrumentez vos applications pour envoyer des données de trace à votre projet Google Cloud, nous vous recommandons de procéder comme suit:
- Utilisez un exportateur qui écrit OTLP dans un collecteur, qui envoie ensuite vos données de trace à l'API Telemetry.
- Utilisez un exportateur OTLP en cours de traitement compatible avec une bibliothèque OpenTelemetry qui envoie la télémétrie à l'API Telemetry. Aucun collecteur n'est associé à cette configuration.
Pour en savoir plus sur l'utilisation de l'API Telemetry, consultez la section Passer de l'exportateur Cloud Trace au point de terminaison OTLP.
Où consulter les données ingérées ?
Les données de trace ingérées via l'API Telemetry peuvent être consultées à l'aide de la page Trace Explorer. Pour savoir comment afficher vos données de trace, consultez Rechercher et explorer des traces.
Données de trace ingérées via l'ancienne page Trace Explorer de l'API Telemetry. Pour en savoir plus, consultez la page Ancien Explorateur de traces: problèmes connus.
Compatibilité avec VPC Service Controls
Le service API Telemetry, dont le nom de service est telemetry.googleapis.com, est un service compatible avec VPC Service Controls. Toutes les restrictions VPC Service Controls que vous créez pour le service API Telemetry ne s'appliquent qu'à ce service. Ces restrictions ne s'appliquent à aucun autre service, y compris ceux comme le service cloudtrace.googleapis.com, qui peuvent également ingérer des données de trace.
Pour en savoir plus, consultez les ressources suivantes :