このドキュメントでは、OpenTelemetry OTLP プロトコルを実装する Telemetry（OTLP）API を使用してトレースデータをGoogle Cloud プロジェクトに送信することをおすすめする理由について説明します。また、アプリケーションの計測方法や、トレースデータを表示できる場所についても説明します。OpenTelemetry SDK のいずれかを使用してアプリケーションを計測する場合、または OpenTelemetry Collector を使用する場合は、Telemetry API を使用できます。
Telemetry API をおすすめする理由は次のとおりです。
この API は、オープンソースの OpenTelemetry エコシステムとの互換性を提供します。また、この API の上限は、独自の Google Cloud API である Cloud Trace API の上限よりも柔軟なことがよくあります。
トレースデータは、OpenTelemetry OTLP プロトコルで定義された proto ファイルと概ね一致する形式で保存されます。一部のフィールドは、保存前に OpenTelemetry 固有のデータ型から JSON データ型に変換されることがあります。ストレージ形式の詳細については、トレースデータのスキーマをご覧ください。
計測は Google Cloud固有のエクスポータに依存しません。
アプリケーション モニタリングなどの一部の機能は、トレースデータを Telemetry API に送信した場合にのみ利用可能な情報に依存しています。
OpenTelemetry は、テレメトリーの取り込みと可視化をサポートする Google Cloudエンジニアが常駐する、 Google Cloudがサポートするオープンソース プロジェクトです。
ベスト プラクティス
アプリケーションを計測してトレースデータをGoogle Cloud プロジェクトに送信する場合は、次のいずれかを行うことをおすすめします。
- OTLP をコレクタに書き込むエクスポータを使用して、トレースデータを Telemetry API に送信します。
- テレメトリーを Telemetry API に送信する OpenTelemetry ライブラリでサポートされているプロセス内 OTLP エクスポータを使用します。この構成のコレクタはありません。
Telemetry API の使用方法については、Cloud Trace エクスポータから OTLP エンドポイントに移行するをご覧ください。
認証
Google Cloud プロジェクトにトレースデータを送信するために必要な認証情報を使用してエクスポータを構成する必要があります。たとえば、Google Cloud アプリケーションのデフォルト認証情報（ADC）を使用してエクスポータを構成するには、言語固有の Google Auth ライブラリをアプリケーションに追加します。詳細とサンプルコードについては、認証を構成するをご覧ください。
Cloud Trace とデータ所在地
データ所在地または影響レベル 4（IL4）の要件があるために Assured Workloads を使用している場合は、Telemetry API を使用してトレーススパンをプロジェクトに送信しないでください。
取り込まれたデータを表示する場所
トレースデータを表示するには、[Trace エクスプローラ] ページと [ログ分析] ページを使用します。詳しくは、以下をご覧ください。