監控程式設計代理活動

監控團隊在 Unity Gateway 中的編碼代理:編碼代理的活動、模型使用情況及請求追蹤。 先從使用量儀表板開始,然後透過追蹤來調查個別請求和代理執行。

使用情況儀表板

開啟Unity Gateway > Govern > 使用情況儀表板。 編碼代理標籤會顯示活動,例如活躍天數、編碼會話、提交次數,以及新增或移除的程式碼行數。 利用儀表板的使用、效能與成本檢視來調查消費與支出。

編碼代理儀表板

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

使用狀況追蹤

查詢 system.ai_gateway.usage,即可依使用者、模型或工作空間分析模型請求,包括權杖用量、延遲和錯誤。 請參閱 「追蹤模型使用」 以了解存取需求及表格結構。

追蹤

Important

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

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

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

建立統一追蹤

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

  1. 打開 Unity Gateway > Govern > Traces ,點選 設定追蹤。
  2. 選擇追蹤表的目錄與結構。
  3. 點選 [儲存]。

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

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

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

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

啟用用戶端追蹤

Unity Gateway CLI 會設定 Claude Code 和 Codex 將追蹤資料傳送到你上面設定的統一追蹤表。

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

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

開發者透過 ug codex 或 ug claude 啟動代理程式。 CLI 會套用追蹤設定,並設定匯出端點與驗證。 若要立即套用更新,請參閱 同步設定更新。

下一步