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-agents dans son ensemble, vous pouvez diagnostiquer les problèmes, optimiser la consommation des 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 intégrés Google Cloud émettent automatiquement des données de télémétrie au format OpenTelemetry. Par exemple, Model Armor émet nativement des données de télémétrie standardisées, ce qui vous permet d'exposer et de surveiller de manière transparente les interceptions de stratégies en temps réel directement dans vos données de trace, sans nécessiter d'instrumentation personnalisée.

Pour obtenir des instructions et connaître les exigences concernant la configuration de la télémétrie des agents, consultez les ressources suivantes :

Topologie des agents

La vue de la topologie multi-agents fournit une carte visuelle à l'échelle du système de l'architecture de votre système multi-agents. Elle affiche les relations et les flux de trafic en temps réel entre tous les agents et serveurs MCP connus de votre Agent Registry. Cette vue agrégée vous aide à comprendre les dépendances complexes et à identifier les goulots d'étranglement potentiels dans votre écosystème.

En plus de la vue de la topologie multi-agents, vous pouvez également afficher les dépendances entrantes et sortantes spécifiques d'un seul agent. Cette vue de la topologie d'un seul agent est basée sur les données de trace de l'agent sélectionné.

Pour obtenir des instructions détaillées sur la navigation et l'interprétation des graphiques de topologie des agents, consultez Afficher les relations et la topologie des agents.

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 son utilisation de l'infrastructure. Utilisez le volet de navigation de gauche de l'onglet Observabilité pour basculer entre les vues suivantes :

  • Présentation : 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'agents. Les graphiques de séries temporelles affichent l'utilisation des jetons (entrée par rapport à la sortie), le volume global du trafic des agents, 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 : décompose 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 et l'utilisation des jetons isolés par modèle spécifique.
  • 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 et de mémoire du conteneur, ainsi que l'utilisation des jetons.
  • Journaux : affiche un flux filtrable de journaux d'agents bruts, y compris la gravité, les codes temporels et les résumés d'exécution pour un dépannage approfondi. Pour en savoir plus, consultez Afficher les journaux des agents.

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

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

Conventions OpenTelemetry pour l'IA générative

Les traces des agents et les journaux d'invites 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 manière dont les données de télémétrie de l'IA générative sont capturées, structurées et signalées.

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 les exécutions d'outils, les étapes de récupération et la consommation de jetons. Cette standardisation facilite l'interopérabilité transparente entre différents backends d'observabilité et outils d'analyse, à l'intérieur et à l'extérieur de Google Cloud.

Étape suivante