使用 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 Admin IAM 角色 (roles/discoveryengine.agentspaceAdmin)。

  • 如要访问 Cloud Logging，您必须具有 Logs Viewer IAM 角色 (roles/logging.viewer)。

  • 已创建 Gemini Enterprise 应用。如需创建应用，请参阅创建应用。

  • 确保数据存储已正确配置并处于有效状态。如需详细了解如何设置数据存储区，请参阅关联 Google 数据源或关联第三方数据源。

  • 开启了可观测性设置，以查看联合连接器错误日志。 如需了解详情，请参阅开启可观测性设置。

访问联邦连接器错误日志

如需查看通过数据联邦与 Gemini Enterprise 连接的数据存储区的错误日志，请按以下步骤操作：

  1. 在 Google Cloud 控制台中，前往 Gemini Enterprise 页面。

    Gemini Enterprise

  2. 在导航菜单中，点击数据存储区。

  3. 选择您所需的数据存储区。

  4. 点击查看日志。系统随即会打开 Logs Explorer 页面。

  5. 如需仅查看 Gemini Enterprise 连接器日志，请在查询编辑器字段中输入以下查询，然后点击运行查询：

     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. 使用过滤条件缩小查询范围。例如，点击所有严重程度，然后选择错误及更严重的。如需详细了解如何优化查询，请参阅示例查询。

访问提取连接器错误日志

如需查看通过数据注入功能连接到 Gemini Enterprise 的数据存储区的错误日志，请按以下步骤操作：

  1. 在 Google Cloud 控制台中，前往 Gemini Enterprise 页面。

    Gemini Enterprise

  2. 在导航菜单中，点击数据存储区。

  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 文档中的将日志路由到支持的目的地。