Googleの推論リクエストのメタデータ記録が正式提供、プロンプトと応答は記録対象外
Google Cloudは2026年10月30日付のGemini Enterprise Agent Platform更新履歴で、推論リクエストのメタデータ記録を一般提供とした。有効にすると、対象となる推論呼び出しごとにモデル、地域、トークン数、Provisioned Throughputの使用、遅延、エラーコードなどをCloud Loggingに構造化して記録でき、プロンプトと回答本文は含まれない。一般提供は機能の提供段階を示すもので、すべてのプロジェクトで初期状態から有効という意味でも、すべてのモデルやAPIが対象という意味でもない。
Google Cloudは2026年10月30日付のGemini Enterprise Agent Platform更新履歴で、推論リクエストのメタデータ記録を一般提供とした。有効にすると、対象となる推論呼び出しごとにモデル、地域、トークン数、Provisioned Throughputの使用、遅延、エラーコードなどをCloud Loggingに構造化して記録でき、プロンプトと回答本文は含まれない。一般提供は機能の提供段階を示すもので、すべてのプロジェクトで初期状態から有効という意味でも、すべてのモデルやAPIが対象という意味でもない。本サイトの発行日は11月2日である。
まず対象となる呼び出しを確認したい。告知はGeminiの`generateContent`と`streamGenerateContent`、Claudeの`rawPredict`と`streamRawPredict`を挙げる。詳細文書は、ほかの提携モデルはこの仕組みでは記録されないと説明する。従量課金とProvisioned Throughputの双方に対応するが、アプリが実際にどの方法を使うかは運用者が確かめる必要がある。対象外のトラフィックを含む全体の報告で、記録の欠落を利用ゼロと読み違えてはならない。この記録は利用と運用のメタデータであり、入出力本文の完全な保存ではない。本文が必要な場合、Googleは別のリクエスト・レスポンス記録を案内している。
設定はProvisioned Throughputの管理画面またはREST APIから行い、プロジェクト全体か、地域内の特定のモデルに適用できる。設定が反映されるまで数分かかる可能性があるため、変更時刻とその後に送った既知の試験リクエストを残すべきだ。詳細文書にはモデル設定を変更する権限とログ用バケットを管理する権限が列挙される。さらに、Observability AnalyticsでSQLを実行したり管理画面の詳細指標を見たりするには、`_Default`バケットの更新が必要だという。この更新は取り消せず、更新前の記録を後からSQLで検索することもできない。ログの有効化、バケットの更新、分析担当者へのアクセス付与は異なる変更として審査したい。
費用と保存期間も運用条件に含まれる。Cloud Loggingへの取り込みと保存には料金がかかり、Observability Analyticsでの問い合わせはCloud Monitoringの利用として請求される。標準のバケット保存期間は30日だ。独自ラベルが多いほど記録の大きさが増え、大量のエージェント呼び出しではログ費用も無視できない。文書は代表的な負荷で一日分のログ量を測り、月額を推定する方法を勧める。プロンプトと回答が記録されないことは収集範囲を小さくするが、独自ラベルに機密識別子を入れれば別の情報漏えいを招き得る。名前の付け方、アクセス、保存と警報を点検すべきだ。
実用例はチーム、アプリ、テナントごとの利用帰属である。クライアントは`x-goog-agent-platform-observability-label-`で始まるヘッダーを送り、Observability Analyticsでそのラベルを検索できる。記録からモデルと地域別のトークン、エラー、遅延、予約済み処理能力の消費や超過も調べられる。しかし業務上の帰属は自動ではない。ヘッダーを送らないクライアントや異なる命名規則のサービスがあれば、集計は全利用を表さない。請求書との照合ではキャッシュ済みトークンと通常のトークン、利用量と請求額の違いにも注意がいる。
小規模な試験では、必要な権限とバケットの扱いを確かめ、明示的に設定を有効にし、反映を待ってから対象のGeminiとClaudeの方法で識別できる要求を送る。Logs Explorerなどでモデル、地域、トークン、エラーの記録を確認する。同時に対象外の方法も調べ、記録がないことをリクエストがないことと混同しないようにする。設定を戻す手順と、残るログの保存方針も記録しておきたい。費用と情報アクセスが変わるため、記事を読んだだけで本番設定の変更を許可されたことにはならない。
監査では記録があることと業務要求が成功したことも別である。失敗した要求にはエラー情報が含まれ得るし、記録の欠落には反映遅延、非対応の方法、検索権限不足などの理由がある。呼び出し側の件数と時間帯を残してログと突き合わせれば、収集の故障と実際の流量変化を分けられる。
今回の提供は推論の運用と費用の帰属をより細かく検証する手段になるが、対象方法、明示的な設定、権限と記録品質に依存する。実際の呼び出しと照合してから継続的な分析に使うべきであり、メタデータ記録をプロンプト全文の監査と呼んではならない。
Sources
FAQ
どの推論方法が記録の対象ですか?
GeminiのgenerateContentとstreamGenerateContent、ClaudeのrawPredictとstreamRawPredictが対象です。他の提携モデルはこの仕組みでは記録されません。設定を明示的に有効にし、アプリの実際の方法を確認する必要があります。
プロンプトや回答本文も保存されますか?
いいえ。モデル、地域、トークン数、遅延、エラーなどの運用メタデータを保存します。本文には別の記録機能が必要です。独自ラベルに機密の利用者識別子を入れないよう、権限と命名方法も確認してください。
有効化の前に何を調べますか?
IAM権限、対象の範囲、ログ費用、標準の30日保存期間を確認します。SQL分析と詳細指標には取り消せない_Defaultバケットの更新が必要です。試験用プロジェクトで設定の反映後に実際の記録を照合します。