分散トレーシングヘッダ（ぶんさんとれーしんぐへっだ）
最終更新：2026/4/25
分散トレーシングヘッダは、複数のサービスをまたがるリクエストの追跡を可能にするために、リクエストと共に伝播されるHTTPヘッダである。
別名・同義語 トレースヘッダトレーシングコンテキスト
ポイント
これらのヘッダは、リクエストがシステム内のどこを通過したかを記録し、パフォーマンスのボトルネックやエラーの原因特定に役立つ。
分散トレーシングヘッダとは
分散トレーシングヘッダは、マイクロサービスアーキテクチャなどの複雑なシステムにおいて、リクエストのライフサイクルを追跡するために不可欠な要素です。単一のリクエストが複数のサービスを通過する際、各サービスがリクエストを処理するのにかかる時間や、発生したエラーなどの情報を収集し、相関付けることを可能にします。
主要なヘッダ
分散トレーシングで一般的に使用されるヘッダには、以下のようなものがあります。
- traceparent: トレースのIDと親スパンのIDを含む、トレースコンテキストの主要なヘッダです。
- tracestate: ベンダー固有のトレースコンテキスト情報を格納するために使用されます。
- spanid: 現在のサービスで実行されているスパンのIDを示します。
- traceid: リクエスト全体を識別する一意のIDです。
これらのヘッダは、OpenTelemetryなどの標準規格に基づいて定義されており、異なるトレースシステム間での相互運用性を高めることを目的としています。
分散トレーシングのメリット
分散トレーシングを導入することで、以下のようなメリットが得られます。