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. |
| Métricas no escopo do agente | Métricas que medem a atividade de um agente individual, como sessões, turnos de conversa e invocações de ferramentas. Eles são listados no tipo de recurso Agente do Gemini Enterprise e coletados apenas quando a configuração de observabilidade Ativar a instrumentação de traces e registros do OpenTelemetry está ativada para esse agente. |
| Métricas no escopo do app | Métricas que medem todo o tráfego de um app, e não de um único agente, como a contagem de solicitações e a latência de ponta a ponta. Eles são listados no tipo de recurso Gemini Enterprise Engine, em que Engine é o nome da API de um app do Gemini Enterprise, e são coletados independentemente das configurações de observabilidade. |
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, ative essa opção nas configurações no nível do app (para o agente Core Assistant) ou na guia Configuração do agente (para agentes criados por funcionários do Agent Designer e agentes Deep Research). Para mais informações, consulte Gerenciar configurações de observabilidade. Essa configuração é obrigatória para as métricas no escopo do agente. As métricas no escopo do app, listadas no tipo de recurso Gemini Enterprise Engine, são coletadas sem ele.
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 doGoogle 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 ). Conector de dados do Gemini Enterprise - Latências de solicitação do conector de dados do Gemini Enterprise (Beta) A latência das solicitações feitas aos conectores de dados do Gemini Enterprise (também chamados de repositórios de dados no console do Google Cloud ) em milissegundos. Mecanismo do Gemini Enterprise: contagem de solicitações do mecanismo do Gemini Enterprise O número total de solicitações recebidas pelo seu app Gemini Enterprise em todo o tráfego para o app, e não em um único agente. Detalhado por método da API, código de resposta gRPC canônico, classe do código de resposta, tipo de consulta e modelo. Mecanismo do Gemini Enterprise - Latência total da solicitação do mecanismo do Gemini Enterprise A distribuição da latência de solicitação de ponta a ponta do seu app Gemini Enterprise. Registrada para cada solicitação, incluindo aquelas que retornam um erro. Mecanismo do Gemini Enterprise: tempo até a primeira resposta Latência A distribuição da latência entre o recebimento de uma solicitação e a transmissão do primeiro token de resposta. Gravado apenas para solicitações que produzem pelo menos um token de resposta. Mecanismo do Gemini Enterprise: latência do tempo até o primeiro token A distribuição da latência entre o recebimento de uma solicitação e a transmissão do primeiro token, seja ele parte do processo de pensamento do modelo ou uma resposta final. Gravado apenas para solicitações que produzem pelo menos um token transmitido. 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 de agentes: 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: o percentil 95 da latência de execuções, categorizado 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 chamada de ferramenta": 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.