使用 Cloud Logging 存取 Gemini Enterprise 連接器錯誤記錄

Gemini Enterprise 提供 Cloud Logging，方便客戶監控將資料連結至 Gemini Enterprise 時發生的錯誤和警告。

本文說明如何使用 Cloud Logging，存取 Gemini Enterprise 的聯合連接器錯誤記錄和擷取連接器錯誤記錄。

基本概念

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

概念	說明
Gemini Enterprise 連接器錯誤記錄	Gemini Enterprise 連接器錯誤記錄會擷取將 Gemini Enterprise 與 Jira 和 Microsoft OneDrive 等第三方資料來源整合時，發生的錯誤和失敗。這些記錄包括連線問題、資料轉換問題和 API 錯誤。

事前準備

存取錯誤記錄前，請務必完成下列事項：

• 如要啟用記錄功能，您必須具備 Gemini Enterprise 管理員 IAM 角色 (roles/discoveryengine.agentspaceAdmin)。

• 如要存取 Cloud Logging，您必須具備記錄檢視者 IAM 角色 (roles/logging.viewer)。

• 已建立 Gemini Enterprise 應用程式。如要建立，請參閱「建立應用程式」。

• 確認資料儲存庫已正確設定並啟用。如要進一步瞭解如何設定資料儲存庫，請參閱「連結 Google 資料來源」或「連結第三方資料來源」。

• 開啟可觀測性設定，查看聯盟連接器錯誤記錄。 詳情請參閱「開啟可觀測性設定」。

存取聯合連接器錯誤記錄

重要術語：在 Gemini Enterprise 中，就 API 而言，應用程式和引擎這兩個詞彙可以互換使用。Gemini Enterprise 引擎是一般搜尋引擎，其中 app_type 欄位設為 APP_TYPE_INTRANET。

如要查看透過資料聯盟連結至 Gemini Enterprise 的資料儲存庫錯誤記錄，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Gemini Enterprise」頁面。

   Gemini Enterprise

2. 點按導覽選單中的「Data Stores」(資料儲存庫)。

3. 選取所需資料儲存庫。

4. 按一下「查看記錄」。「Logs Explorer」頁面隨即開啟。

5. 如要只查看 Gemini Enterprise 連接器記錄，請在查詢編輯器欄位中輸入下列查詢，然後按一下「Run Query」(執行查詢)：

    logName="projects/PROJECT_ID/logs/discoveryengine.googleapis.com%2Fconnector_activity"
    jsonPayload.logMetadata.name="projects/PROJECT_ID/locations/LOCATION/collections/COLLECTION_ID/dataConnector"
   

   更改下列內容：

   • PROJECT_ID：專案的 ID。
   • LOCATION：連接器的位置。例如：global。
   • COLLECTION_ID：包含連結器的集合 ID，也是Google Cloud 控制台中的資料儲存庫 ID。

6. 使用篩選器縮小查詢範圍。例如，按一下「All severities」(所有嚴重程度)，然後選取「Error and higher」(錯誤和更嚴重)。如要進一步瞭解如何調整查詢，請參閱「查詢範例」。

存取擷取連接器錯誤記錄

重要詞彙：在 Gemini Enterprise 中，應用程式一詞與 API 內容中的引擎一詞可互換使用。Gemini Enterprise 引擎是一般搜尋引擎，app_type 欄位設為 APP_TYPE_INTRANET。

如要查看透過資料擷取連結至 Gemini Enterprise 的資料儲存庫錯誤記錄，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Gemini Enterprise」頁面。

   Gemini Enterprise

2. 點按導覽選單中的「Data Stores」(資料儲存庫)。

3. 選取所需資料儲存庫。

4. 按一下「查看記錄」。系統隨即會開啟「Logs Explorer」頁面。

5. 根據預設，Logs Explorer 頁面會搜尋預設記錄範圍中列出的資源，找出記錄項目。如要篩選 Gemini Enterprise 記錄，請執行下列任一操作：

   • 依序選取「所有資源」>「已使用的 API」>「Discovery Engine API」，然後點選「套用」。

   • 在查詢列輸入下列內容，然後點選「Run Query」(執行查詢)：

     resource.type="consumed_api"
     resource.labels.service="discoveryengine.googleapis.com"
     

6. 您可以依 JSON 中繼資料篩選，縮小查詢範圍。舉例來說，如要查詢 ImportDocuments 方法記錄，請執行下列其中一項操作：

   • 在查詢列中輸入下列內容：

     jsonPayload.context.reportLocation.functionName=~"ImportDocuments"
     

   • 展開 JSON 中繼資料，然後點選要篩選的項目：

     

     圖 1：按一下 JSON 中繼資料即可篩選

7. 如要查看大部分警告和錯誤的詳細資料，請參閱 jsonPayload.message 和 jsonPayload.status。

8. 如要深入分析記錄，請將記錄傾印至 BigQuery 等記錄接收器。詳情請參閱 Google Cloud Observability 說明文件中的「將記錄轉送至支援的目的地」。