このドキュメントでは、OpenTelemetry OTLP プロトコルを実装するテレメトリー（OTLP）API について説明します。この API は、OpenTelemetry SDK のいずれかを使用して計測されたアプリケーションで使用するように設計されています。
Telemetry API を使用する理由
Telemetry API は、OTLP 形式のトレースデータの取り込みをサポートしています。Telemetry API を使用すると、データは独自形式に変換されることなく OTLP 形式で保存され、Telemetry API の制限が適用されます。多くの場合、これらの上限は Cloud Trace API の上限よりも緩和されています。最後に、計測は Google Cloud固有のエクスポータに依存しません。
OpenTelemetry は、トレースデータの取り込みと可視化をサポートするエンジニアが常駐する、 Google Cloudサポート対象のオープンソース プロジェクトです。 Google Cloud
Telemetry API を使用する場合
トレースデータを Google Cloud プロジェクトに送信するようにアプリケーションを計測する場合は、次のいずれかを行うことをおすすめします。
- OTLP を コレクタに書き込むエクスポータを使用して、トレースデータを Telemetry API に送信します。
- テレメトリーを Telemetry API に送信する OpenTelemetry ライブラリでサポートされているインプロセス OTLP エクスポータを使用します。この構成のコレクタはありません。
Telemetry API の使用方法については、Cloud Trace エクスポータから OTLP エンドポイントに移行するをご覧ください。
取り込まれたデータを表示する場所
Telemetry API を介して取り込まれたトレースデータは、[Trace Explorer] ページで確認できます。トレースデータを表示する方法については、トレースを検索して調査するをご覧ください。
Telemetry API の以前の [Trace エクスプローラ] ページから取り込まれたトレースデータ。詳細については、従来の Trace エクスプローラ: 既知の問題をご覧ください。
VPC Service Controls のサポート
サービス名が telemetry.googleapis.com の Telemetry API サービスは、VPC Service Controls でサポートされているサービスです。Telemetry API サービスに作成した VPC Service Controls の制限は、そのサービスにのみ適用されます。これらの制限は、トレースデータを取り込むことができる cloudtrace.googleapis.com サービスなどの他のサービスには適用されません。
詳しくは以下をご覧ください。