使用 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，也是控制台中的数据存储区 ID。Google Cloud

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