環境変数

OTEL_LOG_RAW_API_BODIES

Anthropic Messages APIのリクエストおよびレスポンスのJSONをOpenTelemetryログイベントとして出力します。

使い方・用途

  • 企業導入時の監査対応や、モデルとの生データの送受信内容を詳細にデバッグ・調査したい場合に使用します。
  • 1に設定すると60KBで切り詰められたログを出力し、file:<dir>を指定すると切り詰めなしの全文をディスクに保存します。
英語原文(公式ドキュメントより)

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 60 KB, or file:<dir> to write untruncated bodies to disk and emit a body_ref path instead. Disabled by default; bodies include the entire conversation history. 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=file:<dir> が有効な場合、新しい index.jsonl と request_body_id / message.id イベント属性が各レスポンスをリクエストファイルやトランスクリプトのメッセージと紐付けるようになった。

変更後

OTEL_LOG_RAW_API_BODIES=file:<dir> を使うと、レスポンスとリクエストを対応付ける手がかりがなく、トランスクリプトのメッセージとも紐付かなかった。

ユーザーへの恩恵

ユーザーは各 API レスポンスを対応するリクエストファイルやセッショントランスクリプトのメッセージと正確に突き合わせて追跡・分析できる。

関連ドキュメント

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

変更前

モデルが具体的にどのようなデータを送受信しているかの詳細なデバッグが必要な際、中間層でのキャプチャが必要で非常に手間がかかっていました。

変更後

環境変数を有効にするだけで、標準的なオブザーバビリティ・プラットフォームを介して生のAPI通信ログを確認できるようになりました。

ユーザーへの恩恵

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

関連ドキュメント