REST 遙測 (OTLP) API 參考資料

本頁說明導入 OpenTelemetry OTLP 通訊協定的 Telemetry (OTLP) API。如要瞭解這個 API，請參閱「Telemetry API 總覽」。

服務端點

服務端點是指定 API 服務網路位址的基準網址。一項服務可能有多個服務端點。這項服務支援全域服務端點。

HTTP 要求

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

要求主體

要求主體包含 ExportTraceServiceRequest 的例項。如要瞭解這個結構，請參閱 trace_service.proto 和 trace.proto。

如果您將 attributes 新增至 Span，請務必按照 OpenTelemetry 的操作說明進行。詳情請參閱「常見規格概念：屬性」。

如要瞭解如何傳送要求及 OTLP 通訊協定，請參閱「通訊協定詳細資料」。

回應主體

回應主體包含 ExportTraceServiceResponse 的例項。如要瞭解這個結構，請參閱 trace_service.proto。

回應可以表示完全成功、部分成功或失敗。詳情請參閱「OTLP/gRPC 回應」。

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱 Authentication Overview。