環境変数

OTEL_LOG_TOOL_DETAILS

1 を設定すると、OpenTelemetry のメトリクス、トレース、ログに、ツール入力引数、MCP サーバー名、ユーザー作成のワークフロー名、ツール失敗時の生のエラー文字列、api_refusal イベントの拒否カテゴリ、コストおよびトークンメトリクス上の実際のエージェント・スキル・プラグイン・MCP サーバー名、その他のツール詳細を含める。PII (個人を特定できる情報) を保護するためデフォルトでは無効。シェル、ユーザー設定、管理設定のいずれかで設定する。そのセクションに記載されている off 値を除き、プロジェクト設定とローカル設定では無視される。

使い方・用途

  • Edit や Write ツールの span イベントに差分やファイルパスを記録し、ツールの実行内容を OpenTelemetry 上で詳細に追跡したい場合に設定する。
  • MCP サーバー活動の監査において、サーバー名やツール名、呼び出し引数を含む構造化イベントを取得したい場合に設定する。
  • OpenTelemetry のコストやトークンのメトリクスに実際のエージェント・スキル・プラグイン・MCP サーバー名を含めたい場合に設定する。
英語原文(公式ドキュメントより)

Set to 1 to include tool input arguments; MCP server names; user-authored workflow names; raw error strings on tool failures; the refusal category on api_refusal events; real agent, skill, plugin, and MCP server names on cost and token metrics; and other tool details in OpenTelemetry metrics, traces, and logs. Disabled by default to protect PII. Set it in your shell, user settings, or managed settings. Ignored in project and local settings, apart from the off values that section describes. See Monitoring

関連ドキュメント

関連する変更履歴

v2.1.301(1件)

Added
OTEL_LOG_TOOL_DETAILS=1 の際に、OpenTelemetry の tool_decision イベントに classifier_category を追加した。分類器によるブロックがマッチした組み込みルールの名前が記録される。
英語原文を表示
Added classifier_category to OpenTelemetry tool_decision events, naming the built-in rule a classifier block matched, when OTEL_LOG_TOOL_DETAILS=1

変更後

OTel の tool_decision イベントに、許可・拒否を判定した組み込みルール（classifier block）の名前が classifier_category として記録されるため、どの分類ルールがその判断に使われたかを監査ログから確認できる。

関連ドキュメント

v2.1.273(1件)

Changed
OTEL_LOG_TOOL_DETAILS=1 を変更し、コストとトークンのメトリクスに実際のエージェント、スキル、プラグイン、MCP サーバーの名前も含めるようにした
英語原文を表示
Changed OTEL_LOG_TOOL_DETAILS=1 to also include real agent, skill, plugin and MCP server names on cost and token metrics

変更後

OTEL_LOG_TOOL_DETAILS=1 を有効にした際、コストやトークンのメトリクスに実際のエージェント名、スキル名、プラグイン名、MCP サーバー名が含まれるようになり、どのエージェントや機能がコストを生んでいるかを詳細に分析できる。

関連ドキュメント

v2.1.269(1件)

Added
OpenTelemetry のメトリクスとイベントに vcs.* リポジトリ属性をタグ付けするための OTEL_METRICS_INCLUDE_REPOSITORY を追加した。OTEL_LOG_TOOL_DETAILS を設定するとコミットイベントに vcs.ref.head.* が付与される
英語原文を表示
Added OTEL_METRICS_INCLUDE_REPOSITORY to tag OpenTelemetry metrics and events with vcs.* repository attributes; commit events get vcs.ref.head.* with OTEL_LOG_TOOL_DETAILS

変更後

OTEL_METRICS_INCLUDE_REPOSITORY を設定すると、OpenTelemetry のメトリクスやイベントにリポジトリを識別する vcs.* 属性が付与され、共有のcollector でリポジトリ別に利用状況を集計・分析できるようになる。また、OTEL_LOG_TOOL_DETAILS を有効にした場合は commit イベントに vcs.ref.head.* 属性が付与され、どのブランチにコミットしたかまで追跡できる。

関連ドキュメント

v2.1.157(1件)

Added
OTEL_LOG_TOOL_DETAILS=1 設定時、tool_decision テレメトリイベントにツールパラメータ(Bashコマンド、MCP/スキル名)が含まれるようになりました
英語原文を表示
tool_decision telemetry events now include tool_parameters (bash commands, MCP/skill names) when OTEL_LOG_TOOL_DETAILS=1

変更後

組織内での Claude Code の利用実態をより詳細に可視化し、セキュリティ監査やコスト最適化に役立てられます。

関連ドキュメント

v2.1.117(1件)

Added
OpenTelemetry の拡張：スラッシュコマンドのソース情報や、モデルの思考(Effort)レベルごとのコスト・使用量、API リクエスト情報の取得に対応しました
英語原文を表示
OpenTelemetry: user_prompt events now include command_name and command_source for slash commands; cost.usage, token.usage, api_request, and api_error now include an effort attribute when the model supports effort levels. Custom/MCP command names are redacted unless OTEL_LOG_TOOL_DETAILS=1 is set

変更後

開発チーム全体での Claude Code の利用効率やコストパフォーマンスを、より正確なデータに基づいて最適化できます。

関連ドキュメント

v2.1.101(1件)

Improved
ベータ版のトレーシング機能で、プロンプトやツールの詳細・内容を記録する各設定(OTEL_LOG_*)を尊重するように改善
英語原文を表示
Improved beta tracing to honor OTEL_LOG_USER_PROMPTS, OTEL_LOG_TOOL_DETAILS, and OTEL_LOG_TOOL_CONTENT; sensitive span attributes are no longer emitted unless opted in

変更後

組織のセキュリティポリシーに合わせて、安心して利用状況のモニタリングを行えるようになります。

関連ドキュメント

v2.1.85(1件)

Changed
OpenTelemetryのtool_resultイベントに含まれるtool_parametersを、環境変数OTEL_LOG_TOOL_DETAILS=1による制御対象に変更
英語原文を表示
tool_parameters in OpenTelemetry tool_result events are now gated behind OTEL_LOG_TOOL_DETAILS=1

変更後

テレメトリ収集のプライバシー制御が強化され、組織のセキュリティポリシーに合わせた柔軟な運用が可能になります。

関連ドキュメント