環境変数

OTEL_LOG_RAW_API_BODIES

Anthropic Messages API のリクエストおよびレスポンス JSON を api_request_body / api_response_body ログイベントとして出力する。1 を設定するとコンテンツ上限で切り詰められた本文がインラインで出力され、file:<dir> を設定すると切り詰められていない本文をディスクに書き込み、代わりに body_ref のパスを出力する。CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH でコンテンツ上限を設定でき、デフォルトは 60 KB。デフォルトでは無効。本文には会話履歴全体が含まれる。シェル、ユーザー設定、管理設定のいずれかで設定する。プロジェクト設定とローカル設定では無視される。

使い方・用途

  • SDK のメッセージストリームには含まれない system reminder など、Claude Code が実際に受け取った内容を確認したいときに、送信されたリクエスト本文をファイルに記録して調べられる。
  • リクエストとレスポンスを request_body_id や message.id で対応付けて、transcript 上のメッセージの背後にある API の入出力をデバッグしたいときに使う。
  • リトライでパラメータが調整された場合も試行ごとにイベントが発行されるため、どの試行で何が送られ成功したかを OpenTelemetry ログで追跡したいときに使う。
英語原文(公式ドキュメントより)

Emit Anthropic Messages API request and response JSON as api_request_body / api_response_body log events. Set to 1 for inline bodies truncated at the content limit, or file:<dir> to write untruncated bodies to disk and emit a body_ref path instead. CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH configures the content limit, 60 KB by default. Disabled by default; bodies include the entire conversation history. Set it in your shell, user settings, or managed settings. Ignored in project and local settings. See Monitoring

関連ドキュメント

関連する変更履歴

v2.1.274(1件)

Improved
OTEL_LOG_RAW_API_BODIES=file:<dir> の出力を改善した。新しい index.jsonl と request_body_id / message.id のイベント属性により、各レスポンスがリクエストファイルやトランスクリプトのメッセージと紐付けられる
英語原文を表示
Improved OTEL_LOG_RAW_API_BODIES=file:<dir> output: a new index.jsonl and request_body_id / message.id event attributes link each response to its request file and transcript message

変更後

OTEL_LOG_RAW_API_BODIES をファイルモードで利用する際、出力ディレクトリに index.jsonl が追加され、レスポンス本文とリクエスト本文、さらにトランスクリプトのメッセージを event 属性経由で対応付けられるようになる。これにより、多数のファイルに分かれて出力される生ログの中から、特定の応答がどのリクエストから生成され、どの会話メッセージに対応するのかを手掛かりなしで辿れるようになる。

関連ドキュメント

v2.1.111(1件)

Added
APIのリクエストおよびレスポンスのボディ全体をOpenTelemetryログイベントとして出力する環境変数 OTEL_LOG_RAW_API_BODIES を追加しました。
英語原文を表示
Added OTEL_LOG_RAW_API_BODIES environment variable to emit full API request and response bodies as OpenTelemetry log events for debugging

変更後

企業導入時の監査対応や、高度な動作不良の調査において、証跡となる生データを容易に取得できるようになります。

関連ドキュメント