Gemini Enterprise Agent Platform上でClaude Codeを利用している場合、利用状況をGoogle Cloudの標準機能だけで可視化・監視できます。Cloud LoggingとCloud Monitoringを活用することで、API呼び出し回数やトークン消費量をリアルタイムに把握可能です。
この記事でわかること
– Gemini Enterprise Agent PlatformにおけるClaude Code利用のログ取得方法
– Google Cloudネイティブ機能のみでの監視ダッシュボード構築手順
– トークン使用量やコストを可視化するための具体的な設定例
– 運用で注意すべきポイントとベストプラクティス
Gemini Enterprise Agent PlatformとClaude Codeの関係
Gemini Enterprise Agent PlatformはGoogleのエージェント構築基盤ですが、AnthropicのClaude Codeをバックエンドモデルとして呼び出す構成が可能です。この場合、すべてのリクエストはGoogle CloudのAPIレイヤーを経由するため、標準のログ機能で利用状況を記録できます。Claude Code特有のトークン消費やレイテンシも、GCPのログから抽出可能です。
Cloud Loggingで取得できる情報
Claude Codeの呼び出しは、Vertex AIやカスタムエンドポイント経由で発生します。Cloud LoggingではリクエストID、モデル名、入力・出力トークン数、所要時間、エラーステータスなどが自動的に記録されます。特にprotoPayloadに含まれるmodelフィールドでClaudeを識別できるため、フィルタリングが容易です。
Cloud Monitoringでのダッシュボード作成
取得したログを基に、Cloud Monitoringでカスタム指標を作成します。1時間あたりのClaude Code呼び出し数や平均トークン使用量をグラフ化可能です。通知ポリシーを設定すれば、異常なトークン消費が発生した際に即座にアラートを受け取れます。
BigQueryへのログエクスポートと分析
長期的な分析を行う場合は、Cloud LoggingのログをBigQueryにエクスポートします。SQLでユーザーごと・プロジェクトごとの利用傾向を可視化できます。Looker Studioと連携すれば、経営層向けのレポートも簡単に作成可能です。
コスト管理とアラート設定のポイント
Claude Codeはトークン単価が高いため、予算超過を防ぐ仕組みが重要です。Cloud Monitoringで「1日のトークン使用量が閾値を超えた」場合にメール通知を設定しておくと安心です。また、IAMポリシーと組み合わせることで、利用可能なユーザーやサービスアカウントを制限できます。
運用時のベストプラクティス
ログの保持期間を適切に設定し、不要なログは自動削除する運用が推奨されます。また、PIIがログに含まれる可能性があるため、マスキング処理を検討してください。定期的にダッシュボードを確認し、利用パターンの変化を早期に検知することが重要です。
わさびの見解
これまで12プロジェクトでGeminiとClaudeのハイブリッド構成を運用してきましたが、Google Cloudネイティブの監視機能だけで十分に実用的なレベルまで可視化できました。特にBigQuery連携による長期分析は、コスト最適化の意思決定に大きく貢献しています。外部ツールを導入する前に、まずはGCP標準機能でどこまで対応できるかを検証することを強くおすすめします。
コメント