指標にアクセスする

このドキュメントでは、Gemini Enterprise アプリによって生成された指標にアクセスする方法について説明します。これらの指標は、アプリケーションのパフォーマンスと健全性に関する分析情報を提供します。

指標テレメトリーは、Metrics Explorer を使用して表示することも、エージェントの [指標] タブを使用して個々のエージェント内で直接表示することもできます。

主なコンセプト

このセクションでは、Gemini Enterprise のオブザーバビリティに関連する主なコンセプトについて説明します。

コンセプト 説明
指標 指標は、システムが経時的に収集する数値測定です。これらの 測定値は、システムのパフォーマンス、リソース使用率、または 動作を表します。エンジニアは指標を使用して、システムの状態をモニタリングし、 傾向を特定し、アラートをトリガーします。

始める前に

以下のものが揃っていることを確認してください。

  • Gemini Enterprise 管理者 ロールまたは Google Cloud コンソール Gemini Enterprise ユーザーロール。

  • 既存の Gemini Enterprise ウェブアプリ。新しい アプリの作成については、アプリを作成するをご覧ください。

  • Metrics Explorer にアクセスするには、 モニタリング閲覧者ロール （roles/monitoring.viewer）が必要です。

  • [OpenTelemetry のトレースとログの計測を有効にする] オブザーバビリティ設定を有効にします。エージェント タイプに応じて、アプリレベルの構成（Core Assistant エージェントの場合）またはエージェントの [オブザーバビリティ] タブ（Agent Designer の従業員作成エージェントと Deep Research エージェントの場合）で有効にします。詳細については、 オブザーバビリティ設定を管理するをご覧ください。

データの保持

Gemini Enterprise アプリによって生成された指標は、 プロジェクトの Cloud Monitoring に保存され、保持は Cloud Monitoring によって管理されます。 Google Cloud Gemini Enterprise の指標は discoveryengine.googleapis.com/ 接頭辞で公開されます。これは「その他のすべての Google Cloud 指標」階層に該当し、デフォルトで 6 週間 保持されます。保持期間より古いデータは自動的に削除されます。信頼できる 最新の保持値については、 Cloud Monitoring の割り当てと上限ドキュメントの データの保持をご覧ください。

Metrics Explorer で指標にアクセスする

指標にアクセスする手順は次のとおりです。

  1. コンソールで、[Metrics Explorer] ページに移動します。 Google Cloud

    Metrics Explorer に移動

  2. Gemini Enterprise アプリが作成された Google Cloud プロジェクトを選択します。

  3. [指標を選択] をクリックして検索バーを開きます。

  4. 検索バーで、次の指標を探します。

    指標名 説明
    Gemini Enterprise Agent - Gemini Enterprise Agent Session Count Gemini Enterprise エージェントによって処理されたセッションの数。
    Gemini Enterprise Agent - Gemini Enterprise Agent Tool Count Gemini Enterprise エージェントによってツールが呼び出された回数。
    Gemini Enterprise Agent - Gemini Enterprise Agent Turn Count Gemini Enterprise エージェント セッション内の会話ターンの数。
    Gemini Enterprise Agent - Gemini Enterprise Agent Total Latency Gemini Enterprise エージェントからのレスポンスの合計レイテンシ。
    Gemini Enterprise Agent - Gemini Enterprise Agent Tool Total Latency Gemini Enterprise エージェント内のツール実行によって発生した合計レイテンシ。
    Gemini Enterprise DataConnector - Gemini Enterprise DataConnector Request Count Gemini Enterprise データ コネクタ（コンソールではデータストアとも呼ばれます）に対して行われたリクエストの合計数。 Google Cloud

  5. 調べる指標を選択して、[適用] をクリックします。

  6. 必要に応じて、追加のラベルフィルタと集計要素を設定し、時間範囲を調整します。

    Google Cloud コンソールの Metrics Explorer のスクリーンショット。Gemini Enterprise エージェントの指標が表示されています。

エージェントの指標にアクセスする

コンソールのエージェントの [指標] タブで、個々のエージェントのオペレーション、ツール固有、セッションの指標ダッシュボードを直接表示することもできます。 Google Cloud

エージェントの指標にアクセスする手順は次のとおりです。

  1. コンソールで、アプリに移動して [エージェント] をクリックします。 Google Cloud
  2. 検査するエージェントを選択し、[指標] タブをクリックします。

[指標] タブには、主要なオペレーション テレメトリーが [概要] と [ツール] の 2 つのビューに分割されて表示されます。

全体的な指標

このビューには、標準のセッションとエージェントの健康に関するデータをまとめたダッシュボードが表示されます。これには次のものが含まれます。

  • セッション: ユーザー セッションの合計数。
  • セッションあたりの平均時間: セッション中に経過した平均時間。
  • エージェントの呼び出し: エージェントが呼び出された合計回数。
  • エージェントのレイテンシ: 時間と特定の指標にわたるレイテンシ。
  • エージェント トラフィック: インバウンド リクエストのボリューム。
  • エージェントのエラー率: エージェントの呼び出しに失敗した割合。

Google Cloud コンソールの [指標の概要] タブのスクリーンショット。セッション、セッションあたりの平均ターン数、エージェントの呼び出し、レイテンシ、トラフィック、エラー率が表示されています。

ツールの指標

このビューでは、エージェントに接続されているツールの使用状況とレイテンシに特に重点を置いています。これには次のものが含まれます。

  • 呼び出しの合計数: ツールの実行リクエストの数。
  • ツール別の P95 期間: ツール別に分類された実行の 95 パーセンタイルのレイテンシ。
  • ツール別の呼び出し数: さまざまなツールに分割された呼び出しの合計数。
  • ツール別のエラー率: ツール別の実行の失敗率。
  • 「ツール呼び出しなし」の割合: インタラクションでツールの実行がトリガーされなかった割合。

次のステップ