環境変数

OTEL_LOG_TOOL_CONTENT

1 を設定すると、tool.output OpenTelemetry スパンイベントにツールコンテンツを含める。スパン属性は、それぞれのゲートに従ってツールコンテンツを保持する。トレースが必要。機密データを保護するためデフォルトでは無効。シェル、ユーザー設定、管理設定のいずれかで設定する。そのセクションに記載されている off 値を除き、プロジェクト設定とローカル設定では無視される。

使い方・用途

  • 詳細ベータトレーシングの claude_code.tool スパンの tool.output イベントにツール呼び出しの結果内容を含め、テレメトリ上でツールの実行結果を確認したいときに設定する。
  • v2.1.283 以降で追加された MCP ツール・WebFetch・WebSearch の出力を OpenTelemetry スパンイベントとして収集し、監視基盤側でツール出力を分析したいときに設定する。
  • テレメトリに機微データが流れないよう既定では無効になっているツール内容を、自己責任で明示的にオプトインしてトレースに含めたいときに設定する。
英語原文(公式ドキュメントより)

Set to 1 to include tool content in the tool.output OpenTelemetry span event. Span attributes carry tool content under their own gates. Requires tracing. Disabled by default to protect sensitive data. 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.283(1件)

Added
OTEL_LOG_TOOL_CONTENT=1 のとき、MCP ツール、WebFetch、WebSearch の出力を OpenTelemetry の tool.output スパンイベントに含めるようにした
英語原文を表示
Added MCP tool, WebFetch and WebSearch outputs to the tool.output OpenTelemetry span event when OTEL_LOG_TOOL_CONTENT=1

変更後

OTEL_LOG_TOOL_CONTENT=1 を設定した際の tool.output スパンイベントに、MCP ツール、WebFetch、WebSearch の出力も記録されるようになり、これらのツールが返した内容までテレメトリバックエンド上で確認できる。

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

変更後

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

関連ドキュメント