Présentation de l'observabilité

L'observabilité des agents dans Gemini Enterprise Agent Platform offre une visibilité complète sur les performances, le comportement et l'état de vos agents déployés et de vos serveurs MCP (Model Context Protocol). En surveillant les métriques clés, en traçant les chemins d'exécution et en observant votre système multi-agent dans son ensemble, vous pouvez diagnostiquer les problèmes, optimiser la consommation de ressources et améliorer la fiabilité de vos agents.

Ce document présente les outils d'observabilité disponibles dans Gemini Enterprise Agent Platform, y compris la topologie à l'échelle du système, la surveillance des agents individuels et les métriques des serveurs MCP.

Configuration de la télémétrie

Pour remplir ces tableaux de bord, topologies et traces d'observabilité, vos agents doivent être configurés pour envoyer des données de télémétrie au format OpenTelemetry aux systèmes de stockage de Google Cloud Observability.

Assurez-vous que vos environnements d'agent et de serveur MCP sont correctement configurés pour émettre ces données. Les composants Cloud de Confiance by S3NS intégrés émettent automatiquement des données de télémétrie au format OpenTelemetry. Par exemple, Model Armor émet de manière native des données de télémétrie standardisées, ce qui vous permet d'exposer et de surveiller facilement les interceptions de règles en temps réel directement dans vos données de trace, sans nécessiter d'instrumentation personnalisée.

Pour obtenir des instructions et des exigences de configuration de la télémétrie de l'agent, consultez les ressources suivantes :

Signaux d'observabilité

Gemini Enterprise Agent Platform fournit une observabilité via des métriques, des traces et des journaux.

Lorsque vous sélectionnez un agent spécifique dans le registre, l'onglet Observabilité fournit une suite de tableaux de bord ciblés pour surveiller son état opérationnel, ses performances et l'utilisation de l'infrastructure. Utilisez le menu de navigation de gauche dans l'onglet Observabilité pour basculer entre les vues suivantes :

  • Aperçu : suit l'utilisation globale sur la période sélectionnée, y compris le nombre total de sessions, le nombre moyen de tours par session et le nombre total d'appels d'agent. Les graphiques de séries temporelles affichent l'utilisation des jetons (entrée par rapport à la sortie), le volume de trafic global de l'agent, les centiles de latence (p50, p95, p99) et les taux d'erreur.
  • Évaluation : affiche les moniteurs en ligne pour une évaluation continue de la qualité. Cela inclut des widgets de séries temporelles qui suivent la qualité moyenne des réponses, les métriques de sécurité, les taux d'hallucination et la qualité d'utilisation des outils.
  • Modèles : ventile les performances par modèle de fondation sous-jacent. Vous pouvez surveiller la latence p95, le nombre total d'appels, les taux d'erreur, les échecs de quota de débit et l'utilisation des jetons isolés par des modèles spécifiques.
  • Outils : surveille les outils et services externes connectés à l'agent. Cette vue détaille la latence p95, le nombre d'appels et les taux d'erreur par outil, ainsi que la fréquence des interactions où aucun outil n'a été appelé.
  • Utilisation : fournit des métriques au niveau de l'infrastructure pour l'environnement d'exécution de l'agent, y compris l'allocation de processeur du conteneur, l'allocation de mémoire du conteneur et l'utilisation des jetons.
  • Journaux : affiche un flux filtrable de journaux d'agent bruts, y compris la gravité, les codes temporels et les synthèses d'exécution pour une présentation détaillée du dépannage. Pour en savoir plus, consultez Afficher les journaux de l'agent.

En plus des tableaux de bord de l'onglet Observabilité, vous pouvez utiliser l'onglet Traces de l'agent pour inspecter l'exécution étape par étape de sessions spécifiques, y compris les graphes orientés acycliques des segments et des entrées/sorties. Pour en savoir plus, consultez Afficher les traces de l'agent. Vous pouvez également utiliser l'onglet Topologie pour afficher les dépendances entrantes et sortantes spécifiques à cet agent.

Pour les serveurs MCP, vous pouvez surveiller le nombre de requêtes et la durée des requêtes p95 pour suivre l'utilisation et la réactivité.

Auditer les actions des agents

Pour faciliter les audits de sécurité et de conformité de l'entreprise, Gemini Enterprise Agent Platform utilise la journalisation à double attribution pour enregistrer l'activité des agents dans Cloud Logging. Lorsqu'un agent effectue une action ou appelle un outil au nom d'une personne (autorité déléguée par l'utilisateur), les journaux d'audit et d'exécution enregistrent à la fois l'identité de l'agent basée sur SPIFFE (principal://... dans les journaux d'audit ou spiffe://... dans les journaux d'exécution) et l'identité de l'utilisateur humain à l'origine de l'action. Lorsqu'un agent agit de manière autonome sous sa propre autorité, les journaux attribuent l'action directement à l'identité unique de l'agent.

Les auditeurs et les administrateurs de sécurité peuvent isoler et examiner les événements initiés par l'agent dans Cloud Logging en filtrant l'indicateur is_agentic=true dans les requêtes de journaux. En combinant is_agentic=true avec l'identité de l'agent ou le compte principal de l'utilisateur, vous pouvez tracer les chemins d'exécution de bout en bout et vérifier l'application des règles pour toutes les interactions de l'agent.

Conventions d'IA générative OpenTelemetry

Les traces d'agent et les journaux de prompts et de réponses s'appuient fortement sur les conventions sémantiques OpenTelemetry pour les systèmes d'IA générative afin de standardiser la façon dont la télémétrie de l'IA générative est capturée, structurée et signalée.

Le respect de ces conventions est essentiel pour le traçage des agents, car il établit un format universel et indépendant du fournisseur pour décrire les workflows d'agents complexes en plusieurs étapes, tels que l'exécution d'outils, les étapes de récupération et la consommation de jetons. Cette standardisation facilite l'interopérabilité entre différents backends d'observabilité et outils d'analyse, à la fois dans et en dehors de Cloud de Confiance by S3NS.

Étapes suivantes