Ver métricas das ferramentas de IA para desenvolvedores

Este documento descreve como visualizar métricas de uso e telemetria para ferramentas de IA para desenvolvedores em sua organização, como o Google Antigravity e a CLI do Antigravity. Essas métricas mostram a adoção do usuário, o consumo de tokens, as chamadas de API e a execução de ferramentas.

Antes de começar

Antes de visualizar as métricas das ferramentas de IA para desenvolvedores, verifique se você atende aos seguintes pré-requisitos:

  • Ativar as ferramentas de IA para desenvolvedores: para visualizar as métricas das ferramentas de IA para desenvolvedores, sua organização precisa ativar as ferramentas de IA para desenvolvedores do projeto. Consulte Ativar as ferramentas de IA para desenvolvedores.

  • Conta do Cloud Billing com fatura: seu projeto precisa ter o Cloud Billing ativado e uma conta com fatura. Consulte tipos de conta do Cloud Billing.

  • Edições compatíveis: os usuários precisam de uma assinatura das edições Gemini Enterprise Standard, Plus, Standard Emerging Market ou pagamento por uso.

  • Papéis necessários: para acessar a página Métricas de ferramentas para desenvolvedores no Google Cloud console, você precisa do papel de administrador do Gemini Enterprise (roles/discoveryengine.agentspaceAdmin).

Acessar o painel de métricas

Para visualizar as métricas das ferramentas de IA para desenvolvedores no Google Cloud console do Cloud, faça o seguinte:

  1. No Google Cloud console do Cloud, acesse a página Gemini Enterprise.

    Acessar o Gemini Enterprise

  2. Selecione o Google Cloud projeto em que você ativou as ferramentas de IA para desenvolvedores.

  3. No menu de navegação, clique em Métricas de ferramentas para desenvolvedores.

  4. Use os controles de período no canto superior direito do painel para ajustar o período do relatório:

    Controle Descrição
    Menu do seletor de período Por padrão, o painel mostra dados dos últimos 1 dia com a atualização automática ativada. Clique no menu para fazer o seguinte:
    • Digite uma duração personalizada diretamente no campo de filtro Tempo relativo (por exemplo, 15m, 1h, 1d, ou 1w).
    • Selecione um período relativo predefinido: Hoje, Ontem, Últimos 15 minutos, Últimos 30 minutos, Última 1 hora, Últimas 3 horas, Últimas 6 horas, Últimas 12 horas, Último 1 dia, Últimos 2 dias, Últimos 7 dias, ou Últimos 14 dias.
    • Clique em Horários de início e término para especificar uma data e hora de início e término personalizadas para o período do relatório.
    • Clique em Por volta de um horário para especificar uma data e hora e mostrar as métricas centradas nesse carimbo de data/hora.
    • Clique em Fuso horário para selecionar um fuso horário de exibição diferente para os gráficos (por exemplo, PDT (UTC-7)).
    Setas esquerda e direita Desloque o período do relatório para trás () ou para frente () no tempo pela duração selecionada no menu. Por exemplo, se Último 1 dia estiver selecionado, clicar em vai deslocar os gráficos para trás em um dia.
    Diminuir o zoom do período Clique em para diminuir o zoom de um período específico. Todos os gráficos são atualizados para mostrar dados do período com zoom reduzido. Para aumentar o zoom e redefinir a visualização, selecione uma duração no Menu do seletor de período.
    Atualização automática Ative ou desative a atualização automática dos dados do painel ao visualizar um período relativo. Quando um período absoluto é selecionado (como horários de início e término personalizados ou um período histórico de janela), a atualização automática é desativada porque a atualização automática não é compatível com períodos absolutos.

Analisar os dados do gráfico

Cada gráfico no painel Métricas de ferramentas para desenvolvedores oferece controles interativos para ajudar você a inspecionar série temporal, correlacionar métricas com registros e analisar dados subjacentes:

Controle Descrição
Informações Ao lado do título do gráfico, clique em Informações para conferir detalhes sobre os filtros, agrupamentos e propriedades de agregação aplicados à consulta de métricas do gráfico.
Criar política de alertas Em gráficos de linhas de métricas, clique em Criar política de alertas na barra de ferramentas do gráfico para abrir o fluxo de trabalho de alertas no Cloud Monitoring pré-preenchido com a consulta de série temporal do gráfico. Em seguida, você pode configurar as condições de limite e os canais de notificação canais da métrica.
Analisar dados Na barra de ferramentas do gráfico, clique em Analisar dados para abrir a consulta de métricas no Metrics Explorer. No Metrics Explorer, você pode inspecionar, filtrar, agrupar e modificar a consulta de série temporal subjacente em diferentes dimensões ou salvar visualizações personalizadas em um painel personalizado.
Visualizar em tela cheia Na barra de ferramentas do gráfico, clique em Mais opções de gráfico e selecione Visualizar em tela cheia para expandir o gráfico e preencher a tela para uma inspeção detalhada das série temporal e dos dados de legenda.
Inspecionar registros relacionados É possível correlacionar dados de métricas com entradas de registro gravadas no mesmo período para solucionar problemas de atividade e erros:
  • Visualização do painel: na barra de ferramentas do gráfico, clique em Mais opções de gráfico e selecione Inspecionar registros relacionados para abrir um painel de visualização dividida mostrando o gráfico ao lado das entradas de registro correlacionadas.
  • Dica de ferramenta de ponto de dados: em qualquer série temporal do gráfico, mantenha o ponteiro sobre um ponto de dados específico e selecione Inspecionar registros relacionados na dica de ferramenta. Nesse modo, o painel de visualização dividida filtra as entradas de registro para uma janela de cinco minutos antes e depois do carimbo de data/hora selecionado.

Métricas disponíveis

A tabela a seguir lista todas as métricas disponíveis no painel.

Seção Nome da métrica Descrição
Usuários ativos (adoção) Um usuário ativo é um usuário exclusivo que iniciou pelo menos uma ação de ferramenta de IA para desenvolvedores (como uma solicitação de API, um comando ou uma execução de ferramenta) durante o período do relatório.
Usuários ativos por hora (média) Mostra o número médio de usuários ativos exclusivos por hora no período selecionado.
Usuários ativos por dia (média) Mostra o número médio de usuários ativos exclusivos por dia no período selecionado.
Usuários ativos por semana (média) Mostra o número médio de usuários ativos exclusivos por semana no período selecionado.
Usuários ativos por mês (média) Mostra o número médio de usuários ativos exclusivos por mês (usuários ativos de 28 dias) no período selecionado.
Usuários ativos por hora Um gráfico de linhas de tendência que mostra o número de usuários ativos exclusivos por hora no período selecionado.
Usuários ativos por dia Um gráfico de linhas de tendência que mostra o número de usuários ativos exclusivos por dia no período selecionado.
Usuários ativos por semana Um gráfico de linhas de tendência que mostra o número de usuários ativos exclusivos por semana no período selecionado.
Usuários ativos por mês Um gráfico de linhas de tendência que mostra o número de usuários ativos exclusivos por mês (usuários ativos de 28 dias) no período selecionado.
Ferramentas e chamadas de API Total de tokens O número total de tokens de entrada e saída combinados consumidos por ferramentas de IA para desenvolvedores no período selecionado.
Uso diário de tokens Um gráfico de linhas que mostra o consumo diário de tokens ao longo do tempo.
Chamadas de API diárias Um gráfico de linhas que mostra a contagem diária de chamadas de API feitas por ferramentas de IA para desenvolvedores, incluindo um detalhamento de erros por rótulo error_type (por exemplo, limites de cota, erros de autenticação ou erros do cliente).
Chamadas de ferramentas diárias Um gráfico de linhas que mostra a contagem diária de chamadas de ferramentas iniciadas por ferramentas de IA para desenvolvedores.
Chamadas de ferramentas diárias aceitas Um gráfico de linhas que mostra a contagem diária de sugestões de chamadas de ferramentas propostas pelo agente que os usuários aceitaram e executaram.

Limitações

As seguintes limitações se aplicam às métricas de ferramentas de IA para desenvolvedores:

  • As métricas Chamadas de ferramentas diárias e Chamadas de ferramentas diárias aceitas não mostram dados.

A seguir