REST Telemetry (OTLP) API-Referenz

Auf dieser Seite wird die Telemetry (OTLP) API beschrieben, die das OpenTelemetry OTLP Protocol implementiert. Weitere Informationen zu dieser API finden Sie unter Telemetry API – Übersicht.

Dienstendpunkt

Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Ein Dienst kann mehrere Dienstendpunkte haben. Dieser Dienst unterstützt einen globalen Dienstendpunkt.

HTTP-Anfrage

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

Anfragetext

Der Anfragetext enthält eine Instanz von ExportTraceServiceRequest. Informationen zu dieser Struktur finden Sie unter trace_service.proto und trace.proto.

Wenn Sie einer Span eine attributes hinzufügen, folgen Sie der Anleitung von OpenTelemetry. Weitere Informationen finden Sie unter Gängige Spezifikationskonzepte: Attribut.

Informationen zum Senden von Anfragen und zum OTLP-Protokoll finden Sie unter Protokolldetails.

Antworttext

Der Antworttext enthält eine Instanz von ExportTraceServiceResponse. Informationen zu dieser Struktur finden Sie in trace_service.proto.

Die Antwort kann einen vollständigen, teilweisen oder keinen Erfolg anzeigen. Weitere Informationen finden Sie unter OTLP-/gRPC-Antwort.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.