监控 Gemini Code Assist 用量

本文档介绍了如何监控贵组织的 Gemini Code Assist 用量。

Gemini Code Assist 会自动收集指标并将其存储在 Cloud Monitoring 中。您可以使用 Cloud Monitoring 中的数据可视化和分析工具来帮助解答重要问题，例如贵组织中每天有多少活跃用户使用 Gemini Code Assist。启用并使用 Gemini Code Assist 后，系统会自动显示此信息中心，其中包含一些最重要的指标，让您可以快速查看汇总的使用情况数据。

限制

Gemini Code Assist 指标数据记录仅限于用户在 IDE 中与 Gemini Code Assist 的互动。

Gemini Code Assist 指标（包括token 指标）在项目级层汇总，不会报告单个用户的 token 数量。

准备工作

如需获得使用 Google Cloud 控制台查看指标数据所需的权限，请让您的管理员为您授予项目的 Monitoring Viewer (roles/monitoring.viewer) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

此外，用户还必须具有项目的 Gemini Cloud Assist User (roles/geminicloudassist.user) 角色，才能收集其用量指标并将数据发送到信息中心。

可用指标

下表列出了适用于 Gemini Code Assist 的指标。所有指标均在 cloudaicompanion.googleapis.com/Instance 资源类型下报告。

一般活跃用户指标

这些指标用于跟踪在不同时间范围内看到 Gemini Code Assist 服务提供的回答的用户数量。

指标 名称
code_assist/hourly_active_user_count 每小时活跃用户数
code_assist/daily_active_users 日活跃用户数
code_assist/weekly_active_user_count 周活跃用户数
code_assist/twenty_eight_day_active_users 28 天活跃用户

代码建议和互动指标

这些指标用于统计在 IDE 中或通过 Gemini CLI 向用户显示并被用户接受的 Gemini Code Assist 代码回答的数量。

指标 名称
code_assist/code_suggestions_count 代码建议数量
code_assist/code_suggestions_accepted_count 已接受的代码建议数
code_assist/code_lines_accepted_count 接受的代码行数
code_assist/chat_conversation_count Chat 对话
code_assist/chat_responses_count Chat 回答数量
code_assist/chat_responses_accepted_count 接受的 Chat 回答数

平台和用量指标

这些指标会跟踪平台级的使用情况，包括 API 调用次数和使用的 token 数量。

指标 名称
code_assist/used_tokens_count 已使用的 token 数量
code_assist/api_calls_count API 调用次数

Token 和配额指标

以下指标可跟踪贵组织的模型 token 消耗量和超额用量：

指标 名称
usage/token_count 总 token 数（输入、输出和缓存）

查看项目中的 Gemini Code Assist 指标

如需查看 Gemini Code Assist 的汇总指标，请执行以下操作：

  1. 前往 Gemini Code Assist 概览页面。

    前往 Gemini Code Assist 概览

  2. 点击左侧导航菜单中的指标。

后续步骤