Datadog APM トレーサーは、分散型トレーシングのために B3 や W3C Trace Context のヘッダーの抽出と挿入をサポートしています。
分散したヘッダーの挿入と抽出は、挿入および抽出スタイルを構成することで制御されます。tracecontext
、datadog
、b3multi
、b3 single header
のスタイルがサポートされています。
- 環境変数
DD_TRACE_PROPAGATION_STYLE_INJECT=tracecontext,b3mutli
を用いて挿入スタイルを構成します。 - 環境変数
DD_TRACE_PROPAGATION_STYLE_EXTRACT=tracecontext,b3multi
を用いて抽出スタイルを構成します。 - 環境変数
DD_TRACE_PROPAGATION_STYLE=tracecontext,b3multi
を用いて挿入スタイルと抽出スタイルの両方を構成します。
これらの環境変数の値は、挿入または抽出が有効になっているヘッダースタイルのコンマ区切りリストです。デフォルトでは、tracecontext,Datadog
スタイルが有効になっています。
トレースコンテキストの伝搬を無効にするには、環境変数の値を none
に設定します。
- 環境変数
DD_TRACE_PROPAGATION_STYLE_INJECT=none
を用いて挿入スタイルを無効にする - 環境変数
DD_TRACE_PROPAGATION_STYLE_EXTRACT=none
を用いて抽出スタイルを無効にする - 環境変数
DD_TRACE_PROPAGATION_STYLE=none
を使って、すべてのトレースコンテキストの伝搬を無効にします (挿入と抽出の両方)。
複数の環境変数が設定されている場合、DD_TRACE_PROPAGATION_STYLE_INJECT
と DD_TRACE_PROPAGATION_STYLE_EXTRACT
は DD_TRACE_PROPAGATION_STYLE
で指定した値をオーバーライドします。
複数の抽出スタイルが有効になっている場合、そのスタイルが設定された順序で抽出が試みられ、最初に成功した抽出値が使用されます。その後、有効なトレースコンテキストが見つかった場合、それらは終了され、スパンリンクとして追加されます。さらに、tracecontext
スタイルが有効な場合、W3C Traceparent が抽出されたコンテキストと一致すると、W3C Tracestate が伝播されます。
その他の参考資料