ClaudeCloudflare Developer Platform2026/03/17 0:00

AI Gateway - Log AI Gateway request metadata without storing payloads

要点だけを先に読めるように短く再構成したセクションです。

元記事

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

claudejamodel: claude-sonnet-4-20250514

AI Gateway - ペイロードを保存せずにリクエストメタデータをログ記録

Key Points

  • ペイロード保存制御ヘッダーの追加
  • メタデータのみのログ記録が可能
  • 機密データ保護とメトリクス収集の両立

Summary

AI Gatewayに新しいヘッダー cf-aig-collect-log-payload が追加され、リクエストとレスポンスのボディをログに保存するかどうかを制御できるようになりました。

Key Points

  • デフォルトでは cf-aig-collect-log-payload: true でペイロードがメタデータと共に保存される
  • cf-aig-collect-log-payload: false に設定することで、ペイロード保存をスキップ可能
  • ペイロードを保存しない場合でも、以下のメタデータは引き続きログ記録される:
    • トークン数
    • モデル名
    • プロバイダー
    • ステータスコード
    • コスト
    • 実行時間
  • 機密性の高いプロンプトやレスポンスデータを永続化せずに使用量メトリクスを取得したい場合に有用

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

claudejamodel: claude-sonnet-4-20250514

AI Gateway - ペイロードを保存せずにAI Gatewayリクエストメタデータをログに記録

AI Gateway

AI Gatewayで、リクエストとレスポンスのボディをログに保存するかどうかを制御するcf-aig-collect-log-payloadヘッダーがサポートされました。デフォルトでは、このヘッダーはtrueに設定されており、ペイロードはメタデータと一緒に保存されます。

このヘッダーをfalseに設定すると、ペイロードの保存をスキップしながら、以下のようなメタデータのログ記録は継続されます:

  • トークン数
  • モデル
  • プロバイダー
  • ステータスコード
  • コスト
  • 実行時間

これは、使用状況メトリクスが必要だが、機密性の高いプロンプトやレスポンスデータを永続化したくない場合に便利です。

使用例

curl https://gateway.ai.cloudflare.com/v1/$ACCOUNT_ID/$GATEWAY_ID/openai/chat/completions \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --header 'cf-aig-collect-log-payload: false' \
  --data '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": "What is the email address and phone number of user123?"
      }
    ]
  }'

詳細については、Loggingを参照してください。