Documentation de référence sur l'API REST Telemetry (OTLP)

Cette page décrit l'API Telemetry (OTLP), qui implémente le protocole OTLP OpenTelemetry. Pour en savoir plus sur cette API, consultez la présentation de l'API Telemetry.

Point de terminaison de service

Un point de terminaison de service est une URL de base qui spécifie l'adresse réseau d'un service d'API. Un service peut posséder plusieurs points de terminaison de service. Ce service est compatible avec un point de terminaison de service global.

Requête HTTP

POST https://telemetry.googleapis.com/v1/traces

Corps de la requête

Le corps de la requête contient une instance de ExportTraceServiceRequest. Pour en savoir plus sur cette structure, consultez les fichiers trace_service.proto et trace.proto.

Si vous ajoutez attributes à un Span, veillez à suivre les instructions d'OpenTelemetry. Pour en savoir plus, consultez la section Concepts de spécification courants: attribut.

Pour en savoir plus sur l'envoi de requêtes et sur le protocole OTLP, consultez la section Détails du protocole.

Corps de la réponse

Le corps de la réponse contient une instance de ExportTraceServiceResponse. Pour en savoir plus sur cette structure, consultez le fichier trace_service.proto.

La réponse peut indiquer un succès total, un succès partiel ou un échec. Pour en savoir plus, consultez la section Réponse OTLP/gRPC.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/trace.append
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez Authentication Overview.