Visão geral da observabilidade

A observabilidade do agente na Gemini Enterprise Agent Platform oferece visibilidade abrangente do desempenho, do comportamento e da integridade dos agentes implantados e dos servidores do Protocolo de Contexto de Modelo (MCP, na sigla em inglês). Ao monitorar as principais métricas, 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 apresenta uma visão geral das ferramentas de observabilidade disponíveis na Gemini Enterprise Agent Platform, incluindo topologia de 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 integrados do Cloud de Confiance by S3NS emitem automaticamente telemetria no formato do OpenTelemetry. Por exemplo, o Model Armor emite nativamente telemetria padronizada, permitindo que você exponha e monitore facilmente interceptações de políticas em tempo real diretamente nos dados de trace, sem precisar de nenhuma instrumentação personalizada.

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

Indicadores de observabilidade

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

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

  • Visão geral:monitora o uso geral 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:exibe monitores on-line para avaliação contínua de qualidade. Isso inclui widgets de série temporal que monitoram a qualidade média das respostas, as métricas de segurança, as taxas de alucinação e a qualidade do uso de ferramentas.
  • Modelos:detalha o desempenho pelo modelo de fundação subjacente. É possível monitorar a latência p95, o 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 do contêiner, alocação de memória do contêiner e uso de tokens.
  • Registros agênticos:mostra um fluxo filtrável de registros brutos do agente, incluindo gravidade, carimbos de data/hora e resumos executivos para investigação de problemas. Para mais informações, consulte Ver registros agênticos.

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 Ver traces do agente. Também é possível usar a guia Topologia para ver 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 o uso e a capacidade de resposta.

Como auditar ações de agentes

Para dar suporte a auditorias de segurança e compliance corporativas, a Gemini Enterprise Agent Platform usa geração de registros de atribuição dupla para registrar a atividade do agente no Cloud Logging. Quando um agente executa uma ação ou chama uma ferramenta em nome de uma pessoa (autoridade delegada pelo usuário), os registros de auditoria e execução registram a identidade do agente baseada em SPIFFE (principal://... nos registros de auditoria ou spiffe://... nos registros de execução) e a identidade do usuário humano que iniciou a ação. Quando um agente age de forma autônoma, os registros atribuem a ação diretamente à identidade exclusiva do agente.

Os auditores e administradores de segurança podem isolar e analisar eventos iniciados por agentes no Cloud Logging filtrando a flag is_agentic=true em consultas de registro. Combinar is_agentic=true com a identidade do agente ou o principal do usuário permite rastrear caminhos de execução de ponta a ponta e verificar a aplicação de políticas em todas as interações do agente.

Convenções de IA generativa do OpenTelemetry

Os traces 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 entre diferentes back-ends de observabilidade e ferramentas de análise, dentro e fora do Cloud de Confiance by S3NS.

A seguir