監控程式設計代理活動

監控 Unity Gateway 的程式碼代理採用率、權杖使用情況及會話支出。 查詢使用紀錄以進行自訂分析,利用內建儀表板比較代理程式並調查會話,或檢查詳細代理活動的追蹤記錄。

檢查 ug CLI 中的使用情況

從你的終端機檢查你的個人和共用 Unity Gateway 支出上限:

ug usage

輸出範例:

Your Unity Gateway spend limits

[█████████████████████████░░░░░] 85% used
Monthly personal limit (budget 8f3c2a91)
$85.00 of $100.00 used · $15.00 remaining this month

[██████████████████░░░░░░░░░░░░] 60% used
Monthly shared limit (budget 4d7b9e02)

[███████░░░░░░░░░░░░░░░░░░░░░░░] 25% used
Daily personal limit (budget 8f3c2a91)
$5.00 of $20.00 used · $15.00 remaining today

輸出顯示最多五個適用限制以及每個限制的已使用百分比,並依已使用百分比由高到低排序。 執行 ug usage --all 以查看所有適用的限制。

欲了解更多資訊,請參閱 ug CLI 參考資料。

使用狀況追蹤

Unity Gateway 將模型與 MCP 請求記錄在 system.ai_gateway.usage 中,包括提出請求的使用者、工作區、服務及狀態。 模型請求還包括模型、令牌使用情況及延遲資訊。

表格中也包含以下編碼代理程式活動的工作階段中繼資料:

  • 會話與子代理 ID:將請求連接到程式設計工作階段及其子代理。
  • 編碼代理程式與代理版本:識別代理及其回報的版本。
  • Surface:以空格分隔的 Surface 清單,代表完整的客戶端堆疊。
  • 推理工作量與智慧路由名稱:描述請求的推理設定及回報的路由配方。

關於存取需求及完整結構描述,請參見「追蹤模型使用」。 關於會話欄位,請參見 會話元資料。

使用情況儀表板

打開 Unity Gateway > 管理>使用儀表板,然後選擇 Coding Agents。

使用此分頁來:

  • 追蹤採用情況:比較不同程式碼代理間的活躍使用者與會話。
  • 了解工作流程:了解開發人員使用哪些代理框架,以及將這些框架與哪些程式代理配對。
  • 比較使用量:檢視每位用戶的平均每日會話數、每個會話的代幣數,以及每個會話的子代理數。
  • 探索模型使用:查看哪些模型被用於編碼代理會話。 一個會話可以使用多個模型。
  • 調查工作階段支出:檢視 依預估支出排序的前 1000 個工作階段,以識別高支出工作階段,並檢視其使用者、模型、服務、代幣使用量及子代理。

使用 Coding Agents 選擇器來專注於特定的代理人。 會話指標反映選定日期內的活動。 工作階段持續時間包含已錄製的通話之間的閒置時間;它不衡量實際編碼時間。

編碼代理儀表板

如果尚未建立儀表板,帳號管理員可以從 「管理 > 建立使用量儀表板」建立。 請參閱 內建使用儀表板。

智慧路由分頁

Important

智慧路由 目前還在 測試階段。 帳戶管理員必須在帳戶主控台的預覽頁面啟用強化版 Unity Gateway預覽功能。 請參閱 管理 Azure Databricks 預覽。

打開 Unity Gateway > Govern > 使用儀表板,然後選擇 智慧路由。

使用此分頁來:

  • 追蹤節省:查看智慧路由總共節省了多少支出,以百分比和每週為單位。
  • 衡量採用率:比較每日完全採用 Smart Routing 的工作階段和使用者,與未完全採用 Smart Routing 的工作階段和使用者。
  • 監控退出情況:查看使用者至少一次選擇退出智慧路由的會話百分比。
  • 比較模型組合:比較不同模型族群中智慧路由與非智慧路由請求的代幣份額,觀察組合隨時間的變化。

節省金額為估計值。 儀表板比較了智慧路由請求的標價成本與在基線模型上執行相同請求的成本:Codex 的 GPT-6.1 Sol 與 Claude Code 的 Claude Opus 5.5。 預估的節省會扣除路由呼叫本身的成本。 若基線模型成本低於智慧路由所選模型,預估的節省可能會為負數。

如果 Smart Routing 標籤沒有出現,帳號管理員可以將儀表板更新到最新範本。 請參閱 更新儀表板。

智慧路由儀表板

追蹤

Important

統一的追蹤表目前仍處於 Beta 版本。 帳戶管理員必須在帳戶主控台的預覽頁面啟用強化版 Unity Gateway預覽功能。 請參閱 管理 Azure Databricks 預覽。

統一追蹤表將閘道請求追蹤與用戶端代理追蹤存放在同一 Unity 目錄資料表中:

  • Gateway 追蹤會擷取由 Unity Gateway 處理的模型和 MCP 請求。 當你啟用統一追蹤時,收集就會開始。
  • 用戶端追蹤 會擷取編碼代理在開發人員的電腦上發出的活動。 透過 Unity Gateway CLI 啟用它們,將代理執行細節加入同一個資料表。

建立統一追蹤

啟用 Enhanced Unity Gateway 預覽後,Metastore 管理員只需為附加於 metastore 的工作區建立一次追蹤表:

  1. 開啟 Unity Gateway > 可觀察>性追蹤,然後點選「設定追蹤」。
  2. 選擇追蹤表的目錄與結構。
  3. 點選 [儲存]。

追蹤資料會儲存在設定期間選取的 Unity Catalog 位置:<catalog>.<schema>.<table>。 開啟 可觀察性 > 追蹤 以檢視它們,或在 Databricks SQL 中查詢資料表。 資料表擁有者必須先授權存取權限,其他使用者才能查詢。

Traces 檢視,顯示 Claude 程式碼與模型請求,位於同一統一的 trace 表格中

關於存取控制與查詢範例,請參閱 使用統一追蹤表監控所有 AI 活動。 關於欄位與範圍屬性,請參閱統一追蹤表結構參考。

在 Beta 階段,統一追蹤表有一些限制。 請參閱限制。

啟用用戶端追蹤

Unity Gateway CLI 會設定 Claude Code、Codex 和 GitHub Copilot(CLI 和 Visual Studio Code)來將追蹤資料傳送到你上面設定的統一追蹤表。

在你的 編碼代理設定中,請在每個支援代理的現有 config 物件中新增以下設定,然後發佈更新:

{
  "tracing": {
    "enabled": true
  }
}

開發者透過 ug codex、ug copilot 或 ug claude 啟動代理。 CLI 會套用追蹤設定,並設定匯出端點與驗證。 對於 Visual Studio Code 中的 GitHub Copilot,開發人員會執行 ug configure,並重新啟動 Visual Studio Code。 若要立即套用更新,請參閱 同步設定更新。

若要將用戶端追蹤從你自己的應用程式傳送到統一追蹤表,請參見「從你的應用程式發送用戶端追蹤」。

下一步