存取指標

本文說明如何存取 Gemini Enterprise 應用程式產生的指標。這些指標可深入分析應用程式的效能和健康狀態。

您可以透過 Metrics Explorer 查看指標遙測資料,也可以使用代理程式的「可觀測性」分頁,直接在個別代理程式中查看。

基本概念

本節將介紹 Gemini Enterprise 可觀測性的重要概念。

概念 說明
指標 指標是系統在一段時間內收集的數值測量結果。這些指標代表系統的效能、資源用量或行為。工程師會使用指標監控系統健康狀態、找出趨勢,以及觸發快訊。

事前準備

請確認你已具備以下條件:

  • Gemini Enterprise 管理員角色或 Google Cloud 管理控制台 Gemini Enterprise 使用者角色。

  • 現有的 Gemini Enterprise 網頁應用程式。如要瞭解如何建立新應用程式,請參閱建立應用程式

  • 如要存取 Metrics Explorer,您必須具備「Monitoring 檢視者」角色 (roles/monitoring.viewer)。

  • 啟用「啟用 OpenTelemetry 追蹤記錄和記錄的檢測功能」觀測設定。視代理程式類型而定,您可以在應用程式層級設定 (適用於 Core Assistant 代理程式),或在代理程式的「設定」分頁中啟用這項功能 (適用於 Agent Designer 員工製作的代理程式和 Deep Research 代理程式)。詳情請參閱「管理可觀測性設定」。

資料保留

Gemini Enterprise 應用程式產生的指標會儲存在 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 應用程式的 Google Cloud 專案。

  3. 按一下「選取指標」開啟搜尋列。

  4. 在搜尋列中,尋找下列指標:

    指標名稱 說明
    Gemini Enterprise 代理 - Gemini Enterprise 代理工作階段計數 Gemini Enterprise Agent 處理的工作階段數。
    Gemini Enterprise 代理 - Gemini Enterprise 代理工具計數 Gemini Enterprise 代理叫用工具的次數。
    Gemini Enterprise 代理 - Gemini Enterprise 代理回合數 Gemini Enterprise Agent 工作階段中的對話次數。
    Gemini Enterprise 代理 - Gemini Enterprise 代理總延遲時間 Gemini Enterprise 代理回覆的總延遲時間。
    Gemini Enterprise 代理程式 - Gemini Enterprise 代理程式工具總延遲時間 Gemini Enterprise 代理中工具執行作業所產生的總延遲時間。
    Gemini Enterprise DataConnector - Gemini Enterprise DataConnector 要求計數 向 Gemini Enterprise 資料連接器 (在 Google Cloud 控制台中也稱為資料儲存庫) 發出的要求總數。
  5. 選取要探索的指標,然後按一下「套用」

  6. 視需要設定其他標籤篩選器、匯總元素,以及調整時間範圍。

     Google Cloud 控制台的 Metrics Explorer 螢幕截圖,顯示 Gemini Enterprise Agent 指標。

存取代理程式的指標

您也可以在 Google Cloud 控制台的代理程式「可觀測性」分頁中,直接查看個別代理程式的作業、工具專屬和工作階段指標資訊主頁。

如要存取代理程式的指標:

  1. 在 Google Cloud 控制台中,前往您的應用程式,然後按一下「代理程式」
  2. 選取要檢查的代理程式,然後按一下「可觀測性」分頁標籤。

「可觀測性」分頁提供重要的營運遙測資料,並分為「總覽」和「工具」兩種檢視畫面。

總覽指標

這個檢視畫面會顯示資訊主頁,彙整標準工作階段和服務專員健康狀態資料,包括:

  • 工作階段:使用者工作階段總數。
  • 平均單次工作階段時間:單次工作階段的平均時間長度。
  • 代理程式叫用:代理程式的總呼叫次數。
  • 代理程式延遲時間:一段時間內的延遲時間和特定指標。
  • 代理程式流量:傳入要求量。
  • 代理程式錯誤率:代理程式呼叫失敗的百分比。

螢幕截圖: Google Cloud 控制台的「可觀測性」分頁「總覽」檢視畫面,顯示工作階段、每個工作階段的平均輪次、代理程式叫用次數、延遲時間、流量和錯誤率

工具指標

這個檢視畫面專門顯示連結至代理程式的工具使用情況和延遲時間,包括:

  • 通話總數:工具執行要求數。
  • 各工具的第 95 百分位數持續時間:按工具分類的執行作業第 95 百分位數延遲時間。
  • 各工具的呼叫次數:不同工具的呼叫次數總和。
  • 各工具的錯誤率:各工具的執行失敗率。
  • 「未呼叫工具」的比率:互動未觸發任何工具執行的比率。

後續步驟