Visão geral da observabilidade

A observabilidade de agentes na Gemini Enterprise Agent Platform oferece visibilidade abrangente sobre o desempenho, o comportamento e a integridade dos agentes implantados e dos servidores do Protocolo de Contexto de Modelo (MCP). Ao monitorar métricas importantes, rastrear caminhos de execução e observar o sistema multiagente como um todo, é possível diagnosticar problemas, otimizar o consumo de recursos e melhorar a confiabilidade dos agentes.

Este documento oferece uma visão geral das ferramentas de observabilidade disponíveis na Gemini Enterprise Agent Platform, incluindo topologia em todo o sistema, monitoramento de agentes individuais e métricas do servidor MCP.

Configuração de telemetria

Para preencher esses painéis, topologias e traces de observabilidade, seus agentes precisam ser configurados para enviar dados de telemetria no formato OpenTelemetry para sistemas de armazenamento no Google Cloud Observability.

Verifique se os ambientes do agente e do servidor MCP estão configurados corretamente para emitir esses dados. Os componentes Google Cloud integrados emitem automaticamente telemetria no formato OpenTelemetry. Por exemplo, o Model Armor emite telemetria padronizada de forma nativa, permitindo expor e monitorar interceptações de políticas em tempo real diretamente nos dados de rastreamento sem exigir instrumentação personalizada.

Para instruções e requisitos de configuração da telemetria do agente, consulte os seguintes recursos:

Topologia do agente

A visualização de topologia multiagente fornece um mapa visual em todo o sistema da arquitetura do sistema multiagente. Ela mostra as relações e os fluxos de tráfego em tempo real de todos os agentes e servidores MCP conhecidos pelo seu Agent Registry. Essa visualização agregada ajuda a entender dependências complexas e identificar possíveis gargalos no seu ecossistema.

Além da visualização da topologia multiagente, também é possível conferir as dependências de entrada e saída específicas de um único agente. Essa visualização de topologia de agente único se baseia em dados de rastreamento do agente selecionado.

Para instruções detalhadas sobre como navegar e interpretar gráficos de topologia do agente, consulte Ver relações e topologia do agente.

Indicadores de observabilidade

A Gemini Enterprise Agent Platform oferece observabilidade por métricas, traces e registros.

Ao selecionar um agente específico no registro, a guia Observabilidade oferece um conjunto de painéis direcionados para monitorar a integridade operacional, o desempenho e a utilização da infraestrutura. Use a navegação à esquerda na guia Observabilidade para alternar entre as seguintes visualizações:

  • Visão geral:acompanha o uso de alto nível no período selecionado, incluindo o total de sessões, a média de turnos por sessão e o total de invocações do agente. Os gráficos de série temporal mostram o uso de tokens (entrada x saída), o volume geral de tráfego do agente, os percentis de latência (p50, p95, p99) e as taxas de erro.
  • Avaliação:mostra monitores on-line para avaliação contínua da qualidade. Isso inclui widgets de série temporal que rastreiam a qualidade média da resposta, métricas de segurança, taxas de alucinação e qualidade do uso da ferramenta.
  • Modelos:detalha a performance por modelo de fundação. É possível monitorar a latência p95, a contagem total de chamadas, as taxas de erro, as falhas de cota e o uso de tokens isolados por modelos específicos.
  • Ferramentas:monitora as ferramentas e os serviços externos conectados ao agente. Essa visualização detalha a latência p95, as contagens de chamadas e as taxas de erro por ferramenta, além da frequência de interações em que nenhuma ferramenta foi chamada.
  • Uso:fornece métricas no nível da infraestrutura para o ambiente de execução do agente, incluindo alocação de CPU e memória do contêiner e uso de tokens.
  • Registros:mostra um fluxo filtrável de registros brutos do agente, incluindo gravidade, carimbos de data/hora e resumos de execução para solução de problemas detalhada. Para mais informações, consulte Ver registros do agente.

Além dos painéis na guia Observabilidade, é possível usar a guia Traces do agente para inspecionar a execução detalhada de sessões específicas, incluindo gráficos acíclicos dirigidos de períodos e entradas/saídas. Para mais informações, consulte Visualizar rastreamentos de agentes. Também é possível usar a guia Topologia para conferir as dependências de entrada e saída específicas desse único agente.

Para servidores MCP, é possível monitorar a contagem de solicitações e a duração da solicitação p95 para acompanhar a utilização e a capacidade de resposta.

Convenções de IA generativa do OpenTelemetry

Os rastreamentos de agentes e os registros de comandos e respostas dependem muito das Convenções semânticas do OpenTelemetry para sistemas de IA generativa para padronizar como a telemetria de IA generativa é capturada, estruturada e informada.

Seguir essas convenções é fundamental para o rastreamento de agentes porque estabelece um formato universal e independente de fornecedor para descrever fluxos de trabalho complexos e de várias etapas, como execuções de ferramentas, etapas de recuperação e consumo de tokens. Essa padronização ajuda na interoperabilidade perfeita em diferentes back-ends de observabilidade e ferramentas de análise, dentro e fora do Google Cloud.

A seguir