查看 AI 开发者工具指标

本文档介绍了如何查看组织中 AI 开发者工具（例如 Google Antigravity 和 Antigravity CLI）的使用情况指标和遥测数据。这些指标显示了用户采用率、token 消耗量、API 调用次数和工具执行情况。

准备工作

在查看 AI 开发者工具指标之前，请确保满足以下前提条件：

  • 启用 AI 开发者工具：如需查看 AI 开发者工具指标，您的 组织必须为项目启用 AI 开发者工具。请参阅 启用 AI 开发者工具。

  • 按账单结算的 Cloud Billing 账号：您的项目需要 启用 Cloud Billing 并使用按账单结算的账号。请参阅 Cloud Billing 账号类型。

  • 支持的版本：用户需要订阅 Gemini Enterprise Standard、Plus 版或随用随付版。

  • 所需角色：如需访问 Google Cloud 控制台中的开发者工具指标 页面，您需要 Gemini Enterprise 管理员 (roles/discoveryengine.agentspaceAdmin) 角色。

访问指标信息中心

如需在 Google Cloud 控制台中查看 AI 开发者工具指标，请执行以下 操作：

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

    前往 Gemini Enterprise

  2. 选择您在其中启用了 AI 开发者工具的 Google Cloud 项目。

  3. 在导航菜单中，点击开发者工具指标 。

  4. 使用信息中心右上角的时间范围控件调整报告时间范围：

    控制 说明
    时间范围选择器菜单 默认情况下，信息中心会显示 过去 1 天 的数据，并启用自动实时刷新。 点击该菜单可执行以下任一操作：
    • 直接在 相对时间 过滤条件字段中输入自定义时长（例如 15m、1h、1d 或 1w）。
    • 选择预设的相对时间范围：今天、 昨天、过去 15 分钟、 过去 30 分钟、过去 1 小时、 过去 3 小时、过去 6 小时、 过去 12 小时、过去 1 天、 过去 2 天、过去 7 天或 过去 14 天。
    • 点击开始时间和结束时间 ，为报告窗口指定自定义 开始日期和时间以及结束日期和时间。
    • 点击指定时间前后，指定日期和时间 并显示以该时间戳为中心的指标。
    • 点击时区，为图表选择其他显示 时区（例如 PDT (UTC-7)）。
    向左和向右箭头 根据在菜单中选择的时长，将报告时间范围向后 () 或 向前 () 移动。例如，如果选择 过去 1 天 ，点击 会将图表向后移动一天。
    缩小时间范围 点击可缩小特定 时间范围。所有图表都会更新，以显示缩小后的时间 范围的数据。如需放大并重置视图，请从 时间范围选择器菜单 中选择时长。
    自动刷新 在查看相对时间范围时，开启或关闭信息中心数据的自动实时刷新。如果选择绝对时间范围（例如自定义开始时间和结束时间或历史时间窗口），则会自动停用自动刷新，因为绝对时间范围不支持绝对时间范围。

探索图表数据

开发者工具指标 信息中心上的每个图表都提供交互式控件，可帮助您检查时序、将指标与日志相关联以及分析底层数据：

控制 说明
信息 在图表标题旁边，点击信息可查看 有关应用于图表指标查询的过滤条件、分组和聚合属性的详细信息。
创建提醒政策 在指标折线图中，点击创建提醒政策以在 Cloud Monitoring 中打开提醒工作流，其中预先填充了图表的时序查询。然后，您可以为指标配置阈值条件和通知 渠道。
探索数据 在图表工具栏中，点击探索数据 以在 Metrics Explorer中打开指标查询。 在 Metrics Explorer 中，您可以检查、过滤、分组和修改 底层时序查询，或将 自定义视图保存到自定义信息中心。
全屏查看 在图表工具栏中，点击更多图表选项，然后选择全屏查看，以展开图表并使其填满屏幕，从而详细检查时序和图例数据。
检查相关日志 您可以将指标数据与在同一时间范围内写入的日志条目相关联，以排查活动和错误：
  • 信息中心视图：在图表工具栏中，点击 更多图表选项，然后选择 检查相关日志，以打开拆分视图面板 其中显示了图表以及相关联的日志条目。
  • 数据点提示：在任何图表时序中， 将指针悬停在特定数据点上，然后从提示中选择 检查相关日志。在此 模式下，拆分视图面板会将日志条目过滤到所选时间戳前后五 分钟的时间窗口。

可用指标

下表列出了信息中心上提供的所有指标。

发生后的 5 到 15 分钟内显示在信息中心上。
部分 指标名称 说明
活跃用户（采用率） 活跃用户是指在报告时间范围内至少发起了一项 AI 开发者 工具操作（例如 API 请求、提示或工具执行）的唯一身份用户。
每小时活跃用户数（平均值） 显示所选时间范围内每小时的平均唯一身份 活跃用户数。
每日活跃用户数（平均值） 显示所选时间范围内每日的平均唯一身份活跃用户数。
每周活跃用户数（平均值） 显示所选时间范围内每周的平均唯一身份 活跃用户数。
每月活跃用户数（平均值） 显示所选时间范围内每月的平均唯一身份 活跃用户数（28 天活跃用户数）。
每小时活跃用户数 一个趋势折线图，显示所选时间范围内每小时的唯一身份 活跃用户数。
每日活跃用户数 一个趋势折线图，显示所选时间范围内每日的唯一身份 活跃用户数。
每周活跃用户数 一个趋势折线图，显示所选时间范围内每周的唯一身份 活跃用户数。
每月活跃用户数 一个趋势折线图，显示所选时间范围内每月的唯一身份 活跃用户数（28 天活跃用户数）。
工具和 API 调用 token 总数 AI 开发者工具在所选时间范围内消耗的输入和输出 token 总数。
每日 token 用量 一个折线图，显示每日 token 消耗量随时间的变化。
每日 API 调用次数 一个折线图，显示 AI 开发者 工具每日发出的 API 调用次数，包括按 error_type 标签 （例如配额限制、身份验证错误或客户端错误）划分的错误明细。
每日工具调用次数 一个折线图，显示 AI 开发者工具发起的每日工具调用次数。
每日接受的工具调用次数 一个折线图，显示用户接受并执行的智能体建议的每日工具调用次数

限制

AI 开发者工具指标存在以下限制：

  • 每日工具调用次数 和每日接受的工具调用次数 指标不显示数据。

后续步骤