REST テレメトリー（OTLP）API リファレンス

このページでは、OpenTelemetry OTLP Protocol を実装するテレメトリー（OTLP）API について説明します。この API の詳細については、Telemetry API の概要をご覧ください。

サービス エンドポイント

サービス エンドポイントは、API サービスのネットワーク アドレスを指定するベース URL です。1 つのサービスに複数のサービス エンドポイントが存在することもあります。このサービスはグローバル サービス エンドポイントをサポートしています。

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 をご覧ください。