本文說明如何查看貴組織 AI 開發人員工具 (例如 Google Antigravity 和 Antigravity CLI) 的用量指標和遙測資料。這些指標會顯示使用者採用情形、詞元用量、API 呼叫和工具執行情形。
事前準備
查看 AI 開發人員工具指標前,請確認您符合下列必要條件:
啟用 AI 開發人員工具:貴組織必須為專案啟用 AI 開發人員工具,才能查看 AI 開發人員工具指標。請參閱「啟用 AI 開發人員工具」。
Cloud Billing 帳戶:專案必須啟用 Cloud Billing。請參閱「Cloud Billing 帳戶類型」。
支援的版本:使用者必須訂閱 Gemini Enterprise Standard、Plus、Standard 新興市場 或 即付即用 版本。
必要角色:如要存取Google Cloud 控制台中的「Developer tools metrics」(開發人員工具指標) 頁面,您必須具備 Gemini Enterprise 管理員 (
roles/discoveryengine.agentspaceAdmin) 角色。
存取指標資訊主頁
如要在 Google Cloud 控制台查看 AI 開發人員工具指標,請按照下列步驟操作:
前往 Google Cloud 控制台的「Gemini Enterprise」頁面。
選取已啟用 AI 開發人員工具的 Google Cloud 專案。
在導覽選單中,按一下「Developer tools metrics」(開發人員工具指標)。
使用資訊主頁右上角的日期範圍控制項,調整報表時間範圍:
控制項 說明 時間範圍選取器選單 根據預設,資訊主頁會顯示「最近 1 天」的資料,並啟用自動即時重新整理功能。按一下選單,即可執行下列任一操作: -
直接在「Relative time」(相對時間) 篩選器欄位中輸入自訂時間長度 (例如
15m、1h、1d或1w)。 - 選取預設的相對時間範圍:「今天」、「昨天」、「過去 15 分鐘」、「過去 30 分鐘」、「過去 1 小時」、「過去 3 小時」、「過去 6 小時」、「過去 12 小時」、「過去 1 天」、「過去 2 天」、「過去 7 天」或「過去 14 天」。
- 按一下「開始和結束時間」,指定報表時間範圍的自訂開始和結束日期與時間。
- 按一下「Around a time」(某個時間前後) 指定日期和時間,即可顯示該時間戳記前後的指標。
- 按一下「Time zone」(時區),為圖表選取其他顯示時區 (例如「PDT (UTC-7)」)。
向左和向右箭頭 將報表時間範圍往後 ( ) 或往前 () 調整,調整幅度為選單中選取的時長。舉例來說,如果選取「最近 1 天」,點選即可將圖表往後移一天。縮小日期範圍 按一下 即可縮小特定時間範圍。所有圖表都會更新,顯示縮小日期範圍的資料。如要放大及重設檢視畫面,請從時間範圍選取器選單中選取時間長度。 自動重新整理 查看相對時間範圍時,開啟或關閉資訊主頁資料的自動即時重新整理功能。如果選取絕對日期範圍 (例如自訂開始和結束時間或歷來日期範圍),系統會停用自動重新整理功能,因為自動重新整理功能不支援絕對日期範圍。 -
直接在「Relative time」(相對時間) 篩選器欄位中輸入自訂時間長度 (例如
探索圖表資料
「Developer tools metrics」(開發人員工具指標) 資訊主頁上的每張圖表都提供互動式控制項,可協助您檢查時間序列、將指標與記錄建立關聯,以及分析基礎資料:
| 控制項 | 說明 |
|---|---|
| 資訊 | 按一下圖表標題旁的「資訊」,即可查看套用至圖表指標查詢的篩選器、分組和匯總屬性詳細資料。 |
| 建立警告政策 | 在指標折線圖中,按一下圖表工具列中的「Create alert policy」(建立警告政策),即可在 Cloud Monitoring 中開啟警告工作流程,其中會預先填入圖表的時間序列查詢。接著,您可以為指標設定門檻條件和通知管道。 |
| 探索資料 | 在圖表工具列中,按一下「Explore data」(探索資料),在 Metrics Explorer 中開啟指標查詢。在 Metrics Explorer 中,您可以檢查、篩選、分組及修改不同維度的基礎時間序列查詢,或將自訂檢視畫面儲存至自訂資訊主頁。 |
| 以全螢幕模式查看 | 在圖表工具列中,按一下「More chart options」(更多圖表選項),然後選取「View in full screen」(全螢幕檢視),將圖表展開至填滿螢幕,以便詳細檢查時間序列和圖例資料。 |
| 檢查相關記錄 |
您可以將指標資料與大約在同一時間範圍內寫入的記錄項目建立關聯,以便排解活動和錯誤:
|
可用的指標
下表列出資訊主頁提供的所有指標。
| 區段 | 指標名稱 | 說明 |
|---|---|---|
| 活躍使用者 (採用率) | 活躍使用者是指在報表時間範圍內,至少啟動一項 AI 開發人員工具動作 (例如 API 要求、提示或工具執行) 的不重複使用者。 | |
| 每小時活躍使用人數 (平均) | 顯示所選時間範圍內,每小時不重複活躍使用者的平均人數。 | |
| 每日活躍使用人數 (平均) | 顯示所選時間範圍內,每天不重複活躍使用者的平均人數。 | |
| 每週活躍使用人數 (平均) | 顯示所選時間範圍內,每週平均不重複活躍使用者人數。 | |
| 每月活躍使用人數 (平均) | 顯示所選時間範圍內,每月不重複活躍使用者 (28 天活躍使用者) 的平均人數。 | |
| 每小時活動使用者 | 趨勢折線圖,顯示所選時間範圍內每小時的不重複活躍使用者人數。 | |
| 每日活躍使用者 | 趨勢折線圖,顯示所選時間範圍內每天的不重複活躍使用者人數。 | |
| 每週活躍使用者 | 趨勢折線圖,顯示所選時間範圍內每週的不重複活躍使用者人數。 | |
| 每月活躍使用人數 | 趨勢折線圖,顯示所選時間範圍內每月不重複活躍使用者人數 (28 天活躍使用者)。 | |
| 工具和 API 呼叫 | 總權杖數 | 在所選時間範圍內,AI 開發人員工具消耗的輸入和輸出詞元總數。 |
| 每日詞元用量 | 折線圖,顯示每日權杖用量變化。 | |
| 每日 API 呼叫 |
折線圖,顯示 AI 開發人員工具每日發出的 API 呼叫次數,包括依 error_type 標籤細分的錯誤 (例如配額限制、驗證錯誤或用戶端錯誤)。 |
|
| 每日工具呼叫次數 | 折線圖,顯示 AI 開發人員工具每日啟動的工具呼叫次數。 | |
| 每日接受的工具呼叫次數 | 折線圖,顯示使用者接受並執行的代理提議工具呼叫建議每日數量。 | |
後續步驟
- 如要進一步瞭解可用的工具和功能,請參閱「AI 開發人員工具總覽」。
- 瞭解如何調整開發人員工具設定。詳情請參閱「調整 AI 開發人員工具設定」。
- 瞭解如何使用自訂角色管理存取權。詳情請參閱「建立 AI 開發人員工具的自訂角色」。