Neste documento, descrevemos como visualizar métricas de uso e telemetria de ferramentas para desenvolvedores de IA na 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 conferir as métricas das ferramentas para desenvolvedores de IA, verifique se você atende aos seguintes pré-requisitos:
Ativar as ferramentas para desenvolvedores com IA: para conferir as métricas das ferramentas para desenvolvedores com IA, sua organização precisa ativar essas ferramentas no projeto. Consulte Ativar as ferramentas de IA para desenvolvedores.
Conta do Cloud Billing: seu projeto precisa do Cloud Billing ativado. Consulte os tipos de conta do Cloud Billing.
Edições compatíveis: os usuários precisam de uma assinatura do Gemini Enterprise Standard, Plus, Standard Mercado Emergente ou Pagamento por uso.
Papéis necessários: para acessar a página Métricas das ferramentas para desenvolvedores no console doGoogle Cloud , você precisa do papel de administrador do Gemini Enterprise (
roles/discoveryengine.agentspaceAdmin).
Acessar o painel de métricas
Para conferir as métricas das ferramentas para desenvolvedores de IA no console do Google Cloud , faça o seguinte:
No console Google Cloud , acesse a página Gemini Enterprise.
Selecione o projeto do Google Cloud em que você ativou as ferramentas para desenvolvedores de IA.
No menu de navegação, clique em Métricas de ferramentas para desenvolvedores.
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 exibe dados do Último dia com a atualização automática em tempo real ativada. Clique no menu para fazer o seguinte: -
Digite uma duração personalizada diretamente no campo de filtro Tempo relativo (por exemplo,
15m,1h,1dou1w). - Selecione um período relativo predefinido: Hoje, Ontem, Últimos 15 minutos, Últimos 30 minutos, Última hora, Últimas 3 horas, Últimas 6 horas, Últimas 12 horas, Último 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 Em um horário para especificar uma data e hora e exibir métricas centralizadas 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 para a esquerda e para a direita Mude o período do relatório para trás ( ) ou para frente () pela duração selecionada no menu. Por exemplo, se Último dia estiver selecionado, clicar emvai deslocar os gráficos um dia para trás.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 os dados do período 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 em tempo real 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 uma janela histórica), a atualização automática é desativada porque não é compatível com períodos absolutos. -
Digite uma duração personalizada diretamente no campo de filtro Tempo relativo (por exemplo,
Analisar 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 ver 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, configure as condições de limite e os canais de notificação para a métrica. |
| Analisar dados | Na barra de ferramentas do gráfico, clique em Explorar dados para abrir a consulta de métricas no Metrics Explorer. No Metrics Explorer, é possível 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. |
| Ver em tela cheia | Na barra de ferramentas do gráfico, clique em Mais opções de gráfico e selecione Ver em tela cheia para expandir o gráfico e preencher a tela para uma inspeção detalhada dos dados de série temporal e legendas. |
| Inspecionar registros relacionados |
É possível correlacionar dados de métricas com entradas de registro gravadas no mesmo período para resolver problemas de atividade e erros:
|
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 único que iniciou pelo menos uma ação de ferramenta para desenvolvedores de IA (como uma solicitação de API, um comando ou uma execução de ferramenta) durante o período do relatório. | |
| Atividade por hora (média) | Mostra o número médio de usuários ativos únicos por hora no período selecionado. | |
| Usuários ativos por dia (média) | Mostra o número médio de usuários ativos únicos por dia no período selecionado. | |
| Usuários ativos por semana (média) | Mostra o número médio de usuários ativos únicos por semana no período selecionado. | |
| Usuários ativos por mês (média) | Mostra o número médio de usuários ativos únicos por mês (usuários ativos em 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 únicos 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 únicos 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 únicos 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 únicos por mês (usuários ativos em 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 pelas ferramentas para desenvolvedores de IA 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 para desenvolvedores
de IA, incluindo um detalhamento de erros por rótulo error_type
(por exemplo, limites de cota, erros de autenticação ou erros de cliente).
|
|
| Chamadas de ferramentas diárias | Um gráfico de linhas que mostra a contagem diária de chamadas de ferramentas iniciadas por ferramentas para desenvolvedores de IA. | |
| Chamadas de ferramenta 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. | |
A seguir
- Saiba mais sobre as ferramentas e os recursos disponíveis na visão geral das ferramentas para desenvolvedores de IA.
- Saiba como definir as configurações das ferramentas para desenvolvedores. Para mais informações, consulte Definir as configurações das ferramentas para desenvolvedores de IA.
- Saiba como gerenciar o acesso com papéis personalizados. Para mais informações, consulte Criar papéis personalizados para ferramentas para desenvolvedores de IA.