監控 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 的互動。

事前準備

如要取得使用 Google Cloud 控制台查看指標資料所需的權限，請要求管理員授予您專案的「Monitoring 檢視者 」(roles/monitoring.viewer) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

此外，使用者必須具備專案的「Gemini Cloud Assist 使用者」(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 即時通訊對話
code_assist/chat_responses_count 即時通訊回覆數
code_assist/chat_responses_accepted_count 接受的 Chat 回覆數

平台和用量指標

這些指標會追蹤平台層級的使用情況，包括使用的 API 呼叫和權杖。

指標 名稱
code_assist/used_tokens_count 已使用的權杖數量
code_assist/api_calls_count API 呼叫次數

權杖和配額指標

這些指標會追蹤貴機構的模型權杖用量和超額用量：

指標 名稱
usage/token_count 權杖總數 (輸入、輸出和快取)

查看專案的 Gemini Code Assist 指標

如要查看 Gemini Code Assist 的匯總指標，請按照下列步驟操作：

  1. 前往 Gemini Code Assist 總覽頁面。

    前往 Gemini Code Assist 總覽

  2. 按一下左側導覽選單中的「指標」。

後續步驟