Monitore a atividade do agente de programação
Monitor your team's coding agents in Unity Gateway: coding-agent activity, model usage, and request traces. Start with the usage dashboard, then investigate individual requests and agent execution with tracing.
Painel de uso
Abra Unity Gateway > Govern > Usage Dashboard . A tab Coding Agents mostra atividades como dias ativos, sessões de codificação, commits e linhas de código adicionadas ou removidas. Use as views de uso, desempenho e custo do dashboard para investigar o consumo e os gastos.
Se um painel não tiver sido criado, um administrador de conta poderá criá-lo em Govern > Criar dashboard de uso . Consulte Dashboard de uso integrado.
Acompanhamento de uso
Query system.ai_gateway.usage to analyze model requests by user, model, or workspace, including token usage, latency, and errors. Consulte Track model usage para ver os requisitos de acesso e o esquema da tabela.
Rastreamento
Beta
A tabela de rastreamento unificada está em Beta. Um account admin deve habilitar a prévia do Enhanced Unity Gateway na página Previews do console da account. Consulte Gerenciar prévias do Databricks.
A tabela de rastreamento unificada armazena os rastreamentos de solicitações do gateway e os rastreamentos de agentes no lado do cliente na mesma tabela do Unity Catalog:
- Gateway traces capturam solicitações de modelo e MCP tratadas pelo Unity Gateway. A coleta começa quando você ativa o rastreamento unificado.
- Os rastreios do lado do cliente capturam a atividade emitida pelo agente de codificação na máquina do desenvolvedor. Habilite-os por meio da CLI do Unity Gateway para adicionar detalhes de execução do agente à mesma tabela.
Configurar rastreamento unificado
Com a visualização do Enhanced Unity Gateway ativada, um administrador do metastore cria a tabela de rastreamento uma vez para os workspaces vinculados ao metastore:
- Abra Unity Gateway > Govern > Traces e clique em Set up tracing .
- Selecione o catálogo e o esquema para a tabela de rastreamento.
- Clique em Salvar .
Os rastreamentos são armazenados no local do Unity Catalog selecionado durante a configuração: <catalog>.<schema>.<table>. Abra Govern > Traces para inspecioná-los ou faça uma query na tabela no Databricks SQL. O proprietário da tabela deve conceder acesso antes que outros usuários possam fazer a query dela.
Para controles de acesso e exemplos de query, consulte Monitorar toda a atividade de AI usando a tabela de rastreamento unificada. Para colunas e atributos de intervalo, consulte a Referência do esquema da tabela de rastreamento unificada.
Durante a versão Beta, a tabela de rastreamento unificada tem algumas limitações. Consulte Limitações.
Habilitar o rastreamento no lado do cliente
A CLI do Unity Gateway configura o Claude Code e o Codex para enviar seus rastreamentos para a tabela de rastreamento unificada configurada acima.
Na configuração do agente de codificação, adicione a seguinte configuração dentro do objeto config existente de cada agente compatível e, em seguida, publique a atualização:
{
"tracing": {
"enabled": true
}
}
Os desenvolvedores iniciam o agente por meio de ug claude ou ug codex. A CLI aplica a configuração de rastreamento e configura o endpoint de exportação e a autenticação. Para aplicar uma atualização imediatamente, consulte Sync configuration updates.