指標にアクセスする

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

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

主なコンセプト

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

コンセプト 説明
指標 指標は、システムが経時的に収集する数値測定です。これらの 測定値は、システムのパフォーマンス、リソース使用率、または 動作を表します。エンジニアは指標を使用して、システムの状態をモニタリングし、 傾向を特定し、アラートをトリガーします。
エージェント スコープの指標 セッション、会話ターン、ツール呼び出しなど、個々のエージェントのアクティビティを測定する指標。 これらは [Gemini Enterprise エージェント] リソースタイプの下に表示され、 そのエージェントに対して [OpenTelemetry の トレースとログの計測を有効にする] オブザーバビリティ設定がオンになっている場合にのみ収集されます。
アプリ スコープの指標 単一の エージェントではなく、アプリへのすべてのトラフィックを測定する指標（リクエスト数やエンドツーエンドのレイテンシなど）。これらは [**Gemini Enterprise エンジン**] リソース タイプの下に表示されます。ここで、Engine は Gemini Enterprise app の API 名です。 オブザーバビリティ設定に関係なく収集されます。

始める前に

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

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

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

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

  • [OpenTelemetry のトレースとログの計測を有効にする] オブザーバビリティ設定を有効にします。エージェントのタイプに応じて、アプリレベルの構成（コア アシスタント エージェントの場合）またはエージェントの [構成] タブ（Agent Designer の従業員作成エージェントと Deep Research エージェントの場合）で有効にします。詳細については、 オブザーバビリティ設定を管理するをご覧ください。 この設定は、エージェント スコープの指標に必要です。[Gemini Enterprise エンジン] リソースタイプの下に表示されるアプリ スコープの指標は、この設定なしで収集されます。

データの保持

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

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

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

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

    Metrics Explorer に移動

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

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

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

    指標名 説明
    Gemini Enterprise エージェント - Gemini Enterprise エージェント セッション数 Gemini Enterprise エージェントによって処理されたセッションの数。
    Gemini Enterprise エージェント - Gemini Enterprise エージェント ツール数 Gemini Enterprise エージェントによってツールが呼び出された回数。
    Gemini Enterprise エージェント - Gemini Enterprise エージェント ターン数 Gemini Enterprise エージェント セッション内の会話ターンの数。
    Gemini Enterprise エージェント - Gemini Enterprise エージェントの合計 レイテンシ Gemini Enterprise エージェントからのレスポンスの合計レイテンシ。
    Gemini Enterprise エージェント - Gemini Enterprise エージェント ツールの合計 レイテンシ Gemini Enterprise エージェント内のツール実行によって発生した合計レイテンシ。
    Gemini Enterprise DataConnector - Gemini Enterprise DataConnector リクエスト数 Gemini Enterprise データ コネクタ（コンソール Google Cloud ではデータストアとも呼ばれます）に対して行われたリクエストの合計数。
    Gemini Enterprise DataConnector - Gemini Enterprise DataConnector リクエスト レイテンシ （ベータ版）Gemini Enterprise データ コネクタ（コンソール Google Cloud ではデータストアとも呼ばれます）に対して行われたリクエストのレイテンシ（ミリ秒単位）。
    Gemini Enterprise エンジン - Gemini Enterprise エンジン リクエスト数 単一のエージェントではなく、アプリへのすべてのトラフィックで、 Gemini Enterprise app が受信したリクエストの合計数。API メソッド、正規の gRPC レスポンス コード、レスポンス コードクラス、クエリタイプ、モデル別に分類されます。
    Gemini Enterprise エンジン - Gemini Enterprise エンジン リクエストの合計 レイテンシ Gemini Enterprise app のエンドツーエンドのリクエスト レイテンシの分布。エラーを返すリクエストを含め、すべてのリクエストに対して記録されます。
    Gemini Enterprise エンジン - Gemini Enterprise エンジンから最初の 回答までのレイテンシ リクエストの受信から 最初の回答トークンのストリーミングまでのレイテンシの分布。少なくとも 1 つの回答トークンを生成するリクエストに対してのみ記録されます。
    Gemini Enterprise エンジン - Gemini Enterprise エンジンから最初の トークンまでのレイテンシ リクエストの受信から 最初のトークンのストリーミングまでのレイテンシの分布。トークンが モデルの思考プロセスの一部であるか、最終的な回答であるかに関係なく記録されます。少なくとも 1 つのストリーミング トークンを生成するリクエストに対してのみ記録されます。

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

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

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

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

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

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

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

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

全体的な指標

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

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

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

ツールの指標

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

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

次のステップ