環境変数

OTEL_LOG_USER_PROMPTS

1 を設定すると、OpenTelemetry のトレースとログにユーザープロンプトのテキストを含める。デフォルトでは無効 (プロンプトは伏せ字になる)。シェル、ユーザー設定、管理設定のいずれかで設定する。そのセクションに記載されている off 値を除き、プロジェクト設定とローカル設定では無視される。

使い方・用途

  • ユーザーのプロンプト本文を OpenTelemetry のトレースやログに含めて、チームがどのような指示を Claude Code に出しているか監視・分析できるようにする
  • 既定ではプロンプトが <REDACTED> にマスクされるため、プロンプト内容まで残したい運用ではこの設定を有効にする
  • すでにプロンプト本文を出す運用をしている環境では、設定しなくても OTEL_LOG_ASSISTANT_RESPONSES の挙動がこれに連動するため、アシスタント応答を残すかどうかの制御点にもなる
英語原文(公式ドキュメントより)

Set to 1 to include user prompt text in OpenTelemetry traces and logs. Disabled by default (prompts are redacted). 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.193(1件)

Added
OpenTelemetry ログイベントにモデルの応答テキストを含む claude_code.assistant_response を追加
英語原文を表示
Added claude_code.assistant_response OpenTelemetry log event containing the model's response text. Redacted unless OTEL_LOG_ASSISTANT_RESPONSES=1; when that var is unset it follows OTEL_LOG_USER_PROMPTS, so deployments that already log prompt content will start receiving response content on upgrade — set OTEL_LOG_ASSISTANT_RESPONSES=0 to keep prompts-only.

変更後

組織内での利用において、プロンプトと応答の両方を監視・分析することで、品質改善やコンプライアンスの確認が容易になります。

関連ドキュメント

v2.1.121(1件)

Changed
OpenTelemetry において、LLM リクエストのスパンに stop_reason、gen_ai.response.finish_reasons、および user_system_prompt(OTEL_LOG_USER_PROMPTS で保護)を追加しました。
英語原文を表示
OpenTelemetry: added stop_reason, gen_ai.response.finish_reasons, and user_system_prompt (gated behind OTEL_LOG_USER_PROMPTS) to LLM request spans

変更後

組織内での 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

変更後

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

関連ドキュメント