访问指标

本文档介绍了如何访问 Gemini Enterprise 应用生成的指标。这些指标可帮助您深入了解应用的性能和健康状况。

您可以使用 Metrics Explorer 查看指标遥测数据，也可以直接在各个代理中使用代理的可观测性标签页查看。

主要概念

本部分介绍了与 Gemini Enterprise 中的可观测性相关的关键概念。

概念 说明
指标 指标是系统随时间推移收集的数值衡量结果。这些衡量指标表示系统的性能、资源利用率或行为。工程师使用指标来监控系统健康状况、识别趋势并触发提醒。

准备工作

请确保您已备好：

  • Gemini Enterprise 管理员角色或 Google Cloud 控制台 Gemini Enterprise 用户角色。

  • 现有的 Gemini Enterprise Web 应用。如需了解如何创建新应用，请参阅创建应用。

  • 如需访问 Metrics Explorer，您必须具有 Monitoring Viewer 角色 (roles/monitoring.viewer)。

  • 启用启用 OpenTelemetry 跟踪记录和日志的插桩可观测性设置。根据代理类型，在应用级配置（对于核心助理代理）或代理的配置标签页内（对于 Agent Designer 员工自建代理和 Deep Research 代理）启用此功能。如需了解详情，请参阅管理可观测性设置。

数据保留

Gemini Enterprise 应用生成的指标存储在 Google Cloud 项目中的 Cloud Monitoring 中，其保留期限受 Cloud Monitoring 的管理。Gemini Enterprise 指标以前缀 discoveryengine.googleapis.com/ 发布，属于“所有其他 Google Cloud 指标”层级，默认保留时间为 6 周。系统会自动删除保留期限之前的数据。如需了解权威且最新的保留值，请参阅 Cloud Monitoring 配额和限制文档中的数据保留。

在 Metrics Explorer 中访问指标

如需访问指标，请按以下步骤操作：

  1. 在 Google Cloud 控制台中，前往 Metrics Explorer 页面。

    转到 Metrics Explorer

  2. 选择创建 Gemini Enterprise 应用的 Google Cloud 项目。

  3. 点击选择一个指标以打开搜索栏。

  4. 在搜索栏中，查找以下指标：

    指标名称 说明
    Gemini Enterprise Agent - Gemini Enterprise Agent 会话数 由 Gemini Enterprise 智能体处理的会话数。
    Gemini Enterprise Agent - Gemini Enterprise Agent 工具数量 Gemini Enterprise 代理调用工具的次数。
    Gemini Enterprise Agent - Gemini Enterprise Agent 回合数 Gemini Enterprise 智能体对话会话中的对话回合数。
    Gemini Enterprise Agent - Gemini Enterprise Agent 总延迟时间 Gemini Enterprise 智能体回答的总延迟时间。
    Gemini Enterprise Agent - Gemini Enterprise Agent 工具总延迟时间 Gemini Enterprise 代理中工具执行产生的总延迟时间。
    Gemini Enterprise DataConnector - Gemini Enterprise DataConnector 请求数 向 Gemini Enterprise 数据连接器（在 Google Cloud 控制台中也称为数据存储区）发出的请求总数。

  5. 选择要探索的指标，然后点击应用。

  6. 您可以选择设置其他标签过滤条件、汇总元素并调整时间范围。

    Google Cloud 控制台中 Metrics Explorer 的屏幕截图，显示了 Gemini Enterprise Agent 指标。

智能体的访问指标

您还可以在 Google Cloud 控制台中代理的可观测性标签页上直接查看各个代理的运营、特定工具和会话指标信息中心。

如需访问代理的指标，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往您的应用，然后点击代理。
  2. 选择要检查的代理，然后点击可观测性标签页。

可观测性标签页提供关键的运营遥测数据，分为两个视图：概览和工具。

指标概览

此视图提供了一个信息中心，其中汇总了标准会话和代理健康数据，包括：

  • 会话数：用户会话总数。
  • 每次会话的平均时长：会话期间的平均时长。
  • 智能体调用次数：智能体被调用的总次数。
  • 代理延迟时间：随时间变化的延迟时间和特定指标。
  • 代理流量：入站请求量。
  • 代理错误率：代理调用失败的百分比。

Google Cloud 控制台中“可观测性”标签页的“概览”视图的屏幕截图，显示了会话数、每次会话的平均轮数、代理调用次数、延迟时间、流量和错误率

工具指标

此视图专门关注与代理关联的工具的使用情况和延迟时间，包括：

  • 调用总数：工具执行请求的数量。
  • 按工具统计的 P95 延迟：按工具分类的执行延迟时间的第 95 百分位。
  • 按工具统计的调用次数：总调用次数在不同工具之间的分配情况。
  • 按工具统计的错误率：按工具统计的执行失败率。
  • “未调用工具”比例：未触发任何工具执行的交互所占的比例。

后续步骤