Neste documento, descrevemos como acessar as métricas geradas pelo app Gemini Enterprise. Essas métricas fornecem insights sobre o desempenho e a integridade do aplicativo.
É possível conferir a telemetria de métricas usando o Metrics Explorer ou diretamente nos agentes individuais usando a guia Observabilidade do agente.
Principais conceitos
Esta seção apresenta os principais conceitos relacionados à capacidade de observação no Gemini Enterprise.
| Conceito | Descrição |
|---|---|
| Métricas | As métricas são medidas numéricas que os sistemas coletam ao longo do tempo. Essas medições representam a performance, a utilização de recursos ou o comportamento de um sistema. Os engenheiros usam métricas para monitorar a integridade do sistema, identificar tendências e acionar alertas. |
Antes de começar
Verifique se você tem o seguinte:
A função de administrador do Gemini Enterprise ou a função de usuário do Gemini Enterprise no console Google Cloud .
Um app da Web do Gemini Enterprise. Para informações sobre como criar um novo app, consulte Criar um app.
Para acessar o Metrics Explorer, você precisa ter o papel de Leitor do Monitoring (
roles/monitoring.viewer).Ative a configuração de observabilidade Ativar a instrumentação de traces e registros do OpenTelemetry. Dependendo do tipo de agente, habilite essa opção nas configurações no nível do app (para o agente Assistente principal) ou na guia Configuração do agente (para agentes criados por funcionários no Agent Designer e agentes de Deep Research). Para mais informações, consulte Gerenciar configurações de observabilidade.
Retenção de dados
As métricas geradas pelo app Gemini Enterprise são armazenadas no Cloud Monitoring do seu projeto Google Cloud , e a retenção delas é regida pelo Cloud Monitoring. As métricas do Gemini Enterprise são publicadas com o prefixo discoveryengine.googleapis.com/, que se enquadra no nível "todas as outras métricas do Google Cloud" e é retido por 6 semanas por padrão. Os dados mais antigos que o período de armazenamento são excluídos automaticamente. Para conferir os valores de retenção mais atuais e confiáveis, consulte Retenção de dados na documentação Cotas e limites do Cloud Monitoring.
Acessar métricas no Metrics Explorer
Para acessar as métricas, siga estas etapas:
No console do Google Cloud , acesse a página do Metrics Explorer.
Selecione o projeto Google Cloud em que o app Gemini Enterprise foi criado.
Clique em Selecionar uma métrica para abrir uma barra de pesquisa.
Na barra de pesquisa, procure as seguintes métricas:
Nome da métrica Descrição Agente do Gemini Enterprise: contagem de sessões do agente do Gemini Enterprise O número de sessões processadas pelo agente do Gemini Enterprise. Agente do Gemini Enterprise: contagem de ferramentas do agente do Gemini Enterprise O número de vezes que as ferramentas foram invocadas pelo agente do Gemini Enterprise. Agente do Gemini Enterprise: contagem de turnos do agente do Gemini Enterprise O número de rodadas de conversa nas sessões do agente do Gemini Enterprise. Agente do Gemini Enterprise: latência total do agente do Gemini Enterprise A latência total das respostas do agente do Gemini Enterprise. Agente do Gemini Enterprise: latência total da ferramenta do agente do Gemini Enterprise A latência total incorrida pelas execuções de ferramentas no agente do Gemini Enterprise. Gemini Enterprise DataConnector - Gemini Enterprise DataConnector Contagem de solicitações A contagem total de solicitações feitas aos conectores de dados do Gemini Enterprise (também chamados de repositórios de dados no console do Google Cloud ). Selecione a métrica que você quer analisar e clique em Aplicar.
Se quiser, defina outros filtros de rótulo e elementos de agregação e ajuste o período.
Acessar métricas para agentes
Também é possível acessar painéis de métricas operacionais, específicos da ferramenta e de sessão diretamente para agentes individuais na guia Observabilidade do agente no console do Google Cloud .
Para acessar as métricas de um agente:
- No console Google Cloud , acesse seu app e clique em Agentes.
- Selecione o agente que você quer inspecionar e clique na guia Observabilidade.
A guia Observabilidade oferece telemetria operacional essencial dividida em duas visualizações: Visão geral e Ferramentas.
Métricas de visão geral
Essa visualização fornece um painel que resume os dados padrão de integridade da sessão e do agente, incluindo:
- Sessões: contagem total de sessões do usuário.
- Tempo médio por sessão: tempo médio decorrido durante uma sessão.
- Invocações do agente: total de vezes que o agente foi chamado.
- Latência do agente: latência ao longo do tempo e métricas específicas.
- Tráfego do agente: volume de solicitações de entrada.
- Taxa de erros do agente: porcentagem de invocações de agente com falha.
Métricas de ferramentas
Essa visualização se concentra especificamente no uso e na latência das ferramentas conectadas ao seu agente, incluindo:
- Total de chamadas: número de solicitações de execução de ferramentas.
- Duração P95 por ferramenta: a latência do percentil 95 das execuções, categorizada por ferramenta.
- Contagem de chamadas por ferramenta: número total de chamadas dividido entre diferentes ferramentas.
- Taxa de erros por ferramenta: a taxa de falha das execuções por ferramenta.
- Taxa de"nenhuma ferramenta chamada": a taxa em que as interações não acionaram a execução de nenhuma ferramenta.
A seguir
- Crie painéis com as métricas do Gemini Enterprise. Para mais informações, consulte Criar e gerenciar painéis personalizados.
- Crie alertas quando as métricas ultrapassarem um limite. Para mais informações, consulte Criar políticas de alertas de limite de métrica
- Para desativar o rastreamento do Metrics Explorer, consulte Desativar as configurações de observabilidade.