Skip to content
← リリースに戻る · 2.1.274
改善 / 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

変更の詳細