改善 / v2.1.274
APIボディログの紐付け改善
CHANGELOG 原文(英語)
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=file:<dir>の出力を改善。新しいindex.jsonlと、request_body_idおよびmessage.idのイベント属性により、各レスポンスをリクエストファイルとtranscriptのメッセージに紐付けられるように。
ドキュメント
ドキュメントの抜粋(参考訳)
API response body イベント
OTEL_LOG_RAW_API_BODIES が設定されている場合に、成功した API レスポンスごとに記録されます。
ファイルモード(OTEL_LOG_RAW_API_BODIES=file:<dir>)では、Claude Code は成功したレスポンスごとに、<dir>/index.jsonl にも1行の JSON を追記します。含まれるフィールドは timestamp、session_id、query_source、model、request_id、message_id、message_uuid、request_file、response_file です。これを読むと、テレメトリのバックエンドに問い合わせなくても、特定の会話履歴メッセージの背後にあるリクエストとレスポンスのファイルを見つけられます。このインデックスファイルには Claude Code v2.1.274 以降が必要です。
イベント名: claude_code.api_response_body
属性:
- すべての標準属性
event.name:"api_response_body"event.timestamp: ISO 8601 形式のタイムスタンプevent.sequence: イベント相関属性で説明されている、プロセスごとのイベント順序用カウンターbody: id、コンテンツブロック、usage、stop reason を含む、JSON 形式にシリアライズされた Messages API のレスポンス。コンテンツ上限(既定は 60 KB)で切り詰められます。拡張思考のコンテンツは削除されます。インラインモード(OTEL_LOG_RAW_API_BODIES=1)でのみ出力されます。body_ref: 切り詰められていない本文を含む<dir>/<request_id>.response.jsonファイルへの絶対パス。ファイルモード(OTEL_LOG_RAW_API_BODIES=file:<dir>)でのみ出力されます。body_length: 切り詰められていない本文の長さ。OTEL_LOG_RAW_API_BODIES=file:<dir>の場合は UTF-8 バイト数、=1の場合は UTF-16 コード単位数body_truncated: インラインでの切り詰めが発生した場合は"true"。ファイルモードの場合、および切り詰めが発生しなかった場合は存在しません。model: モデル識別子query_source: リクエストを発行したサブシステムrequest_id: API リクエスト ID。"req_011..."のような形式です。イベント相関属性で説明されています。request_body_id: このレスポンスが応答しているapi_request_bodyイベント のrequest_body_id。Claude Code v2.1.274 以降が必要ですmessage.id: API がレスポンスに割り当てたメッセージ ID、つまりレスポンス本文のidフィールド。Claude Code v2.1.274 以降が必要ですmessage.uuid: レスポンスに対応する会話履歴の最終エントリの UUID。request_body_idと組み合わせることで、会話履歴のメッセージと、その背後にあるリクエストおよびレスポンス本文を関連付けられます。Claude Code v2.1.274 以降が必要です
取得日 · 2026-11-20