オブザーバビリティの概要

Gemini Enterprise Agent Platform のエージェントのオブザーバビリティにより、デプロイされたエージェントと Model Context Protocol（MCP）サーバーのパフォーマンス、動作、健全性を包括的に把握できます。主要な指標をモニタリングし、実行パスをトレースして、マルチエージェント システム全体をモニタリングすることで、問題を診断し、リソース消費を最適化して、エージェントの信頼性を向上させることができます。

このドキュメントでは、Gemini Enterprise Agent Platform で利用可能なオブザーバビリティ ツール（システム全体のトポロジ、個々のエージェントのモニタリング、MCP サーバーの指標など）の概要について説明します。

テレメトリーの設定

これらのオブザーバビリティ ダッシュボード、トポロジ、トレースにデータを入力するには、OpenTelemetry 形式のテレメトリー データを Google Cloud Observability のストレージ システムに送信するようにエージェントを構成する必要があります。

エージェントと MCP サーバー環境が、このデータを出力するように適切に構成されていることを確認します。組み込みの Cloud de Confiance by S3NS コンポーネントは、OpenTelemetry 形式でテレメトリーを自動的に出力します。たとえば、Model Armor は標準化されたテレメトリーをネイティブに出力するため、カスタム計測を必要とせずに、トレースデータ内でリアルタイムのポリシー インターセプトをシームレスに公開してモニタリングできます。

エージェント テレメトリーの設定手順と要件については、次のリソースをご覧ください。

オブザーバビリティ シグナル

Gemini Enterprise Agent Platform は、指標、トレース、ログを通じてオブザーバビリティを提供します。

レジストリから特定のエージェントを選択すると、[オブザーバビリティ] タブに、IT 運用の健全性、パフォーマンス、インフラストラクチャの使用状況をモニタリングするための、ターゲットを絞ったダッシュボードが表示されます。[オブザーバビリティ] タブの左側のナビゲーションを使用して、次のビューを切り替えます。

  • 概要: 選択した期間の全体的な使用状況（合計セッション数、セッションあたりの平均ターン数、エージェントの呼び出しの合計数など）を追跡します。時系列グラフには、トークンの使用量（入力と出力）、エージェントのトラフィック量全体、レイテンシのパーセンタイル（p50、p95、p99）、エラー率が表示されます。
  • 評価: 継続的な品質評価のためのオンライン モニターを表示します。これには、平均レスポンス品質、安全性指標、ハルシネーション率、ツール使用品質を追跡する時系列ウィジェットが含まれます。
  • モデル: 基盤となる基盤モデル別にパフォーマンスを分類します。p95 レイテンシ、合計呼び出し数、エラー率、レートに基づく割り当てエラー、特定のモデルで分離されたトークン使用量をモニタリングできます。
  • ツール: エージェントに接続されている外部ツールとサービスをモニタリングします。このビューには、ツールごとの P95 レイテンシ、呼び出し数、エラー率、ツールが呼び出されなかったインタラクションの頻度が表示されます。
  • 使用状況: エージェントのランタイム環境のインフラストラクチャ レベルの指標（コンテナの CPU 割り当て、コンテナのメモリ割り当て、トークンの使用状況など）を提供します。
  • ログ: フィルタ可能な未加工のエージェント ログのストリームが表示されます。これには、詳細なトラブルシューティングのための重大度、タイムスタンプ、実行の概要が含まれます。詳細については、エージェント ログを表示するをご覧ください。

[オブザーバビリティ] タブのダッシュボードに加えて、エージェントの [トレース] タブを使用して、スパンと入出力の有向非巡回グラフなど、特定のセッションのステップバイステップの実行を検査できます。詳細については、エージェント トレースを表示するをご覧ください。[トポロジ] タブを使用して、その単一エージェントの特定のインバウンド依存関係とアウトバウンド依存関係を表示することもできます。

MCP サーバーの場合、リクエスト数と p95 リクエスト時間をモニタリングして、使用率と応答性を追跡できます。

エージェント アクションの監査

エンタープライズ セキュリティとコンプライアンス監査をサポートするため、Gemini Enterprise Agent Platform はデュアル アトリビューション ロギングを使用して、エージェントのアクティビティを Cloud Logging に記録します。エージェントがユーザーに代わってアクションを実行するか、ツールを呼び出す場合（ユーザー委任権限）、監査ログと実行ログには、SPIFFE ベースのエージェント ID（監査ログの principal://...、または実行ログの spiffe://...）と、開始した人間のユーザーの ID の両方が記録されます。エージェントが独自の権限で自律的に動作する場合、ログにはアクションが固有のエージェント ID に直接関連付けられます。

監査者とセキュリティ管理者は、ログクエリで is_agentic=true フラグをフィルタすることで、Cloud Logging でエージェントが開始したイベントを分離して確認できます。is_agentic=true をエージェント ID またはユーザー プリンシパルと組み合わせることで、エンドツーエンドの実行パスをトレースし、すべてのエージェント インタラクションでポリシーの適用を検証できます。

OpenTelemetry 生成 AI 規則

エージェント トレースとプロンプトとレスポンスのログは、生成 AI システムの OpenTelemetry セマンティック規則に大きく依存して、生成 AI テレメトリーのキャプチャ、構造化、レポートの方法を標準化しています。

これらの規則に準拠することは、エージェント トレースにとって重要です。これにより、ツールの実行、取得ステップ、トークンの消費など、複雑なマルチステップのエージェント ワークフローを記述するための、ベンダーに依存しないユニバーサルな形式が確立されます。この標準化により、 Cloud de Confiance by S3NSの内外で、さまざまなオブザーバビリティ バックエンドと分析ツール間のシームレスな相互運用性が実現します。

次のステップ