環境変数

TRACESTATE

分散トレーシングにおいて、ベンダー固有のトレースメタデータを伝播させるためのW3C準拠の環境変数を読み取ります。

使い方・用途

  • SDK経由や自動化パイプラインの中でClaude Codeを使用する際、外部の監視ツールと内部の挙動を一貫したフローとして紐付けるために利用します。
  • 上位プロセスから渡された既存のトレース情報を継承し、大規模な自動化ワークフロー内でのAIの振る舞いを追跡可能にします。
英語原文(公式ドキュメントより)

In Agent SDK and non-interactive sessions started with -p, Claude Code also reads TRACEPARENT and TRACESTATE from its own environment when starting each interaction span. This lets an embedding process pass its active W3C trace context into the subprocess so Claude Code's spans appear as children of the caller's distributed trace. Interactive sessions ignore inbound TRACEPARENT to avoid accidentally inheriting ambient values from CI or container environments.

関連する変更履歴

v2.1.110(1件)

Changed
SDKおよびヘッドレスセッションにおいて、環境変数からTRACEPARENT/TRACESTATEを読み取り、分散トレーシングのリンクに対応
英語原文を表示
SDK/headless sessions now read TRACEPARENT/TRACESTATE from the environment for distributed trace linking

変更前

SDK経由や非対話モードで実行している際、外部のモニタリングツールなどでシステム全体のトレースを確認しても、Claude Code内部の挙動と紐付けることが困難でした。

変更後

W3C標準のトレースコンテキスト環境変数をサポートし、上位のプロセスから渡されたトレース情報をClaude Code内のスパンと統合して出力できるようになりました。

ユーザーへの恩恵

大規模な自動化パイプラインやマイクロサービスの中でClaude Codeを使用する際、全体の処理フローとAIの挙動を一貫して可視化・デバッグできるようになります。

関連ドキュメント