查看 AI 开发者工具指标

预览

此功能受服务专用条款的“通用服务条款”部分中的“非正式版产品条款”的约束。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

注意：如需使用此功能，您的项目必须与按月账单结算的 Cloud Billing 账号相关联，且该账号每月都会收到有效账单。

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

准备工作

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

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

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

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

  注意： Gemini Enterprise Standard Emerging Market 版仅面向符合条件的客户提供。请与您的 Google 客户支持团队联系，以评估相关要求并确定您是否符合资格条件。

• 所需角色：如需访问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 用量	一个折线图，显示每日令牌消耗量随时间的变化。
	每日 API 调用次数	折线图，显示 AI 开发者工具每日的 API 调用次数，包括按 error_type 标签（例如配额限制、身份验证错误或客户端错误）细分的错误。
	每日工具调用次数	一个折线图，显示 AI 开发者工具每天发起的工具调用次数。 注意：此指标不显示数据。
	每日接受的工具调用次数	一个折线图，显示用户接受并执行的代理建议的工具调用建议的每日数量。 注意：此指标不显示数据。

限制

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

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

后续步骤

• 如需详细了解可用的工具和功能，请参阅 AI 开发者工具概览。
• 了解如何配置开发者工具设置。如需了解详情，请参阅配置 AI 开发者工具设置。
• 了解如何通过自定义角色管理访问权限。如需了解详情，请参阅为 AI 开发者工具创建自定义角色。