環境変数

ENABLE_BETA_TRACING_DETAILED

1を設定し、BETA_TRACING_ENDPOINT を OTLP/HTTP コレクターのエンドポイントに設定すると、コンテンツを含むスパン属性と claude_code.hook スパンを追加する詳細ベータトレーシングが有効になる。対話型 CLI セッションでは、組織がこのベータの許可リストに登録されている必要もある。どちらの変数もプロジェクト設定とローカル設定では無視される。

使い方・用途

  • Span 属性にリクエスト元のサブシステムやクエリ内容を含める (query_source など) ことで、どの経路で発行された LLM リクエストかを OpenTelemetry バックエンド側で詳しく分析したい場合に使う
  • 詳細トレースで追加される claude_code.hook Span を収集し、フックの実行をトレース結果として確認したい場合に使う
  • コンテンツを含む Span 属性がエクスポートされるため、プロジェクト設定やローカル設定からは設定できず、シェル・ユーザー設定・管理設定で信頼できるソースから管理したい場合に使う
英語原文(公式ドキュメントより)

Set to 1, and set BETA_TRACING_ENDPOINT to your OTLP/HTTP collector endpoint, to turn on detailed beta tracing, which adds content-bearing span attributes and the claude_code.hook span. Interactive CLI sessions also require your organization to be allowlisted for the beta. Both variables are ignored in project and local settings

関連ドキュメント