使用 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 資料來源」或「連結第三方資料來源」。

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

存取聯合連接器錯誤記錄

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. 使用篩選器縮小查詢範圍。舉例來說，按一下「所有嚴重程度」，然後選取「錯誤和更高」。如要進一步瞭解如何修正查詢，請參閱「查詢範例」。

存取擷取連接器錯誤記錄

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」，然後按一下「套用」。

    • 在查詢列中輸入以下內容，然後按一下「執行查詢」：

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

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

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

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

    • 展開 JSON 中繼資料，然後按一下即可篩選：

      按一下 JSON 中繼資料進行篩選
      圖 1：按一下 JSON 中繼資料進行篩選

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

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