Riferimento all'API Telemetry (OTLP) REST

Questa pagina descrive l'API Telemetry (OTLP), che implementa il protocollo OpenTelemetry OTLP. Per informazioni su questa API, consulta la panoramica dell'API Telemetry.

Endpoint di servizio

Un endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. Un servizio può avere più endpoint. Questo servizio supporta un endpoint di servizio globale.

Richiesta HTTP

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

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di ExportTraceServiceRequest. Per informazioni su questa struttura, consulta trace_service.proto e trace.proto.

Se aggiungi attributes a un Span, assicurati di seguire le istruzioni di OpenTelemetry. Per ulteriori informazioni, consulta Concetti comuni delle specifiche: attributo.

Per informazioni sull'invio delle richieste e sul protocollo OTLP, consulta Dettagli del protocollo.

Corpo della risposta

Il corpo della risposta contiene un'istanza di ExportTraceServiceResponse. Per informazioni su questa struttura, consulta trace_service.proto.

La risposta può indicare un esito positivo completo, un esito positivo parziale o un errore. Per maggiori informazioni, consulta Risposta OTLP/gRPC.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la sezione Authentication Overview.