本文說明如何存取及查看 Gemini Enterprise 應用程式產生的追蹤記錄和範圍。追蹤記錄和範圍可提供應用程式內要求效能和執行流程的詳細深入分析資料，例如使用助理或代理程式時。
您可以透過追蹤記錄探索器查看追蹤記錄資料，也可以直接在個別代理程式的「追蹤記錄」分頁中查看。
基本概念
本節將介紹 Gemini Enterprise 可觀測性的重要概念。
| 概念 | 說明 |
|---|---|
| 追蹤 |
追蹤記錄是一組跨度，代表單一要求或交易在不同服務和元件間的流動情形。 舉例來說，追蹤記錄代表要求的整個生命週期。包括使用者向 Gemini Enterprise 助理提問、Gemini Enterprise 助理回覆，以及答案觸發的後續動作 (例如傳送電子郵件)。 |
| Span | 時距是追蹤記錄中以時間為單位的單一工作單元。代表特定作業，例如函式呼叫、API 要求或資料庫查詢。每個時距都包含開始和結束時間、專屬 ID，以及與其他時距的關係等詳細資料。這些關係共同構成追蹤記錄。 |
| Span 記錄 | 跨度記錄是與特定跨度相關聯的時間戳記、任意形式的訊息或事件。這些記錄提供有關跨度執行的詳細背景資訊，可協助使用者偵錯問題及瞭解要求流程。 |
事前準備
請確認你已具備以下條件：
Gemini Enterprise 管理員角色或 Google Cloud 管理控制台 Gemini Enterprise 使用者角色。
現有的 Gemini Enterprise 網頁應用程式。如要瞭解如何建立新應用程式，請參閱建立應用程式。
如要存取追蹤記錄，您必須具備 Cloud Trace 使用者角色 (
roles/cloudtrace.user)。啟用「啟用 OpenTelemetry 追蹤記錄和記錄的檢測功能」觀測設定。視代理類型而定，您可以在應用程式層級設定 (適用於 Core Assistant 代理)，或在代理的「設定」分頁中啟用這項功能 (適用於 Agent Designer 員工製作的代理和 Deep Research 代理)。詳情請參閱「管理可觀測性設定」。
資料保留
Gemini Enterprise 應用程式產生的追蹤記錄和範圍會儲存在 Google Cloud 專案的 Cloud Trace 中，保留期限則由 Cloud Trace 控管。根據預設，Cloud Trace 會保留 span 資料 30 天；超過保留期限的資料會自動刪除。如要查看最準確的最新保留值，請參閱 Cloud Trace 配額和限制說明文件中的「Cloud Trace 保留期限」。
在 Trace 探索工具中存取追蹤記錄
如要使用 Trace Explorer 存取追蹤記錄和範圍，請按照下列步驟操作：
前往 Google Cloud 控制台的「Trace Explorer」頁面。
選取建立 Gemini Enterprise 應用程式的 Google Cloud 專案。您會看到專案的所有範圍。
在表格中，按一下「Span ID」(時距 ID)，即可查看追蹤記錄詳細資料，包括時距的持續時間和其他屬性。
代理的存取追蹤記錄
您也可以在代理程式的「追蹤記錄」分頁中，直接查看個別代理程式的追蹤時距，其中會顯示時距追蹤記錄和父項/子項執行結構的詳細時間順序摘要。
如要存取代理程式的追蹤記錄：
- 在 Google Cloud 控制台中，前往您的應用程式，然後按一下「代理程式」。
- 選取要檢查的代理程式，然後按一下「追蹤」分頁標籤。
追蹤記錄摘要表
「追蹤記錄」分頁中的主要表格會顯示每個追蹤記錄時距的下列資訊：
- 狀態：追蹤記錄的目前狀態 (目前顯示「未設定」)。
- 追蹤範圍 ID：追蹤範圍的專屬 ID。按一下 span ID 連結，即可下鑽查看詳細資料。
- 範圍名稱：範圍所執行工作的簡要說明。
- 時距類型：時距類型。選項包括：
Agent to Tool：代理程式對外部工具的叫用。Invoke Agent：代理程式的呼叫。Agent to Model：代理程式向大型語言模型提出的要求。
- 時間長度：完成追蹤時距所需的時間 (以分鐘為單位)。
- 輸入：傳送至範圍的輸入資料或訊息 (如有)。
- 輸出：範圍傳回的輸出結果 (如果有的話)。
- 開始時間：跨度開始執行的確切時間戳記。
詳細追蹤記錄檢視畫面
按一下「追蹤範圍 ID」，即可開啟詳細資料頁面，其中包含：
- 摘要：查看基準中繼資料，包括「開始時間」、「時間長度」和「跨度」總數。您可以點選「在 Cloud Trace 中查看」，或切換「圖表」和「時間軸」檢視畫面按鈕。
- 視覺化：切換圖形階層或時間軸檢視畫面，顯示所有追蹤範圍的上下層關係。
- 所選跨度詳細資料：選取單一跨度即可顯示詳細區段，可能包括：
- 摘要：顯示時距名稱、目標服務、具有這項動作的時距總數，以及總持續時間 (以秒為單位)。
- 記錄：查看相關事件詳細資料 (如有設定)。按一下「查看記錄」，直接前往標準記錄。
- 評估：顯示任何評估結果 (如有設定)。
- 輸入和輸出：完成要求和回應的酬載。
- 記錄檔和事件：列出在此時距執行期間發生的事件。
- 堆疊追蹤：如果時距執行失敗，則為錯誤詳細資料。
- 中繼資料和連結：參照相關雲端資源管理員實體的連結。
- 屬性：資源標記和其他鍵/值可觀測性參數。
