Ce document explique comment accéder aux métriques générées par votre application Gemini Enterprise. Ces métriques fournissent des insights sur les performances et l'état de votre application.
Vous pouvez afficher la télémétrie des métriques à l'aide de l'explorateur de métriques ou directement dans les agents individuels à l'aide de l'onglet Observabilité de l'agent.
Concepts clés
Cette section présente les concepts clés liés à l'observabilité dans Gemini Enterprise.
| Concept | Description |
|---|---|
| Métriques | Les métriques sont des mesures numériques que les systèmes collectent au fil du temps. Ces mesures représentent les performances, l'utilisation des ressources ou le comportement d'un système. Les ingénieurs utilisent les métriques pour surveiller l'état du système, identifier les tendances et déclencher des alertes. |
| Métriques de portée agent | Métriques qui mesurent l'activité d'un agent individuel, telles que ses sessions, ses tours de conversation et ses appels d'outils. Elles sont listées sous le type de ressource Agent Gemini Enterprise et ne sont collectées que lorsque le paramètre d'observabilité Activer l'instrumentation des traces et des journaux OpenTelemetry est activé pour cet agent. |
| Métriques de portée application | Métriques qui mesurent l'ensemble du trafic vers une application plutôt que vers un seul agent, comme le nombre de requêtes et la latence de bout en bout. Elles sont listées sous le type de ressource Moteur Gemini Enterprise, où Moteur est le nom de l'API pour une application Gemini Enterprise, et elles sont collectées quels que soient les paramètres d'observabilité. |
Avant de commencer
Assurez-vous de disposer des éléments suivants :
Le rôle Administrateur Gemini Enterprise ou le rôle Utilisateur Gemini Enterprise de la console Google Cloud .
Une application Web Gemini Enterprise existante. Pour en savoir plus sur la création d'une application, consultez Créer une application.
Pour accéder à l'explorateur de métriques, vous devez disposer du rôle Lecteur Monitoring (
roles/monitoring.viewer).Activez le paramètre d'observabilité Activer l'instrumentation des traces et des journaux OpenTelemetry. Selon le type d'agent, activez cette option dans les configurations au niveau de l'application (pour l'agent Core Assistant) ou dans l'onglet Configuration de l'agent (pour les agents créés par les employés dans Workflow Builder et les agents Deep Research). Pour en savoir plus, consultez Gérer les paramètres d'observabilité. Ce paramètre est obligatoire pour les métriques au niveau de l'agent. Les métriques au niveau de l'application, qui sont listées sous le type de ressource Moteur Gemini Enterprise, sont collectées sans lui.
Conservation des données
Les métriques générées par votre application Gemini Enterprise sont stockées dans Cloud Monitoring dans votre projet Google Cloud , et leur conservation est régie par Cloud Monitoring. Les métriques Gemini Enterprise sont publiées sous le préfixe discoveryengine.googleapis.com/, qui relève du niveau "toutes les autres métriquesGoogle Cloud " et sont conservées pendant six semaines par défaut. Les données antérieures à la période de conservation sont automatiquement supprimées. Pour connaître les valeurs de conservation officielles et les plus récentes, consultez Conservation des données dans la documentation Quotas et limites de Cloud Monitoring.
Accéder aux métriques dans l'Explorateur de métriques
Pour accéder aux métriques, procédez comme suit :
Dans la console Google Cloud , accédez à la page Explorateur de métriques.
Sélectionnez le projet Google Cloud dans lequel votre application Gemini Enterprise a été créée.
Cliquez sur Sélectionner une métrique pour ouvrir une barre de recherche.
Dans la barre de recherche, recherchez les métriques suivantes :
Nom de la métrique Description Gemini Enterprise Agent - Gemini Enterprise Agent Session Count Nombre de sessions gérées par l'agent Gemini Enterprise. Gemini Enterprise Agent - Gemini Enterprise Agent Tool Count Nombre de fois où des outils ont été appelés par l'agent Gemini Enterprise. Gemini Enterprise Agent - Gemini Enterprise Agent Turn Count Nombre de tours de conversation dans les sessions de l'agent Gemini Enterprise. Agent Gemini Enterprise – Latence totale de l'agent Gemini Enterprise Latence totale des réponses de l'agent Gemini Enterprise. Gemini Enterprise Agent - Gemini Enterprise Agent Tool Total Latency Latence totale occasionnée par les exécutions d'outils dans l'agent Gemini Enterprise. Connecteur de données Gemini Enterprise – Nombre de requêtes du connecteur de données Gemini Enterprise Nombre total de requêtes envoyées aux connecteurs de données Gemini Enterprise (également appelés "datastores" dans la console Google Cloud ). Connecteur de données Gemini Enterprise – Latences des requêtes du connecteur de données Gemini Enterprise (Bêta) Latence des requêtes adressées aux connecteurs de données Gemini Enterprise (également appelés datastores dans la console Google Cloud ), en millisecondes. Moteur Gemini Enterprise – Nombre de requêtes du moteur Gemini Enterprise Nombre total de requêtes reçues par votre application Gemini Enterprise, sur l'ensemble du trafic vers l'application plutôt que vers un seul agent. Répartition par méthode d'API, code de réponse gRPC canonique, classe de code de réponse, type de requête et modèle. Moteur Gemini Enterprise - Latence totale des requêtes du moteur Gemini Enterprise Distribution de la latence des requêtes de bout en bout pour votre application Gemini Enterprise. Enregistrée pour chaque requête, y compris celles qui renvoient une erreur. Moteur Gemini Enterprise : latence du délai de première réponse du moteur Gemini Enterprise Distribution de la latence entre la réception d'une requête et la diffusion du premier jeton de réponse. Enregistré uniquement pour les requêtes qui produisent au moins un jeton de réponse. Moteur Gemini Enterprise : latence du délai avant le premier jeton du moteur Gemini Enterprise Distribution de la latence entre la réception d'une requête et la diffusion du premier jeton, que ce jeton fasse partie du processus de réflexion du modèle ou d'une réponse finale. Enregistré uniquement pour les requêtes qui produisent au moins un jeton diffusé. Sélectionnez la métrique que vous souhaitez explorer, puis cliquez sur Appliquer.
Vous pouvez également définir des filtres d'étiquettes supplémentaires et des éléments d'agrégation ainsi qu'ajuster la période.

Accéder aux métriques pour les agents
Vous pouvez également afficher les tableaux de bord des métriques opérationnelles, spécifiques aux outils et de session directement pour chaque agent dans l'onglet Observabilité de l'agent dans la console Google Cloud .
Pour accéder aux métriques d'un agent :
- Dans la console Google Cloud , accédez à votre application, puis cliquez sur Agents.
- Sélectionnez l'agent que vous souhaitez inspecter, puis cliquez sur l'onglet Observabilité.
L'onglet Observabilité fournit des données de télémétrie opérationnelles clés divisées en quatre vues : Présentation, Outils, Latence et Taux d'erreur.
Métriques générales
Cette vue fournit un tableau de bord résumant les données d'état standard des sessions et des agents, qui incluent :
- Sessions : nombre total de sessions utilisateur.
- Durée moyenne par session : temps moyen écoulé pendant une session.
- Appels d'agent : nombre total de fois où l'agent a été appelé.
- Latence de l'agent : latence au fil du temps et métriques spécifiques.
- Trafic de l'agent : volume de requêtes entrantes.
- Taux d'erreur de l'agent : pourcentage d'appels d'agent ayant échoué.

Métriques des outils
Cette vue se concentre spécifiquement sur l'utilisation et la latence des outils connectés à votre agent, y compris :
- Nombre total d'appels : nombre de requêtes d'exécution d'outils.
- Durée P95 par outil : latence au 95e centile des exécutions, classée par outil.
- Nombre d'appels par outil : nombre total d'appels répartis entre les différents outils.
- Taux d'erreur par outil : taux d'échec des exécutions par outil.
- Taux "Aucun outil appelé" : taux d'interactions n'ayant déclenché aucune exécution d'outil.
Statistiques relatives à la latence
Cette vue affiche la latence de réponse de votre agent. Chaque métrique est affichée sous la forme d'une fiche de résumé p50 et p95 pour la période sélectionnée, et d'un graphique de série temporelle montrant les tendances au fil du temps. Vous pouvez également filtrer les métriques de latence par fonctionnalité. La vue affiche les métriques suivantes :
- Délai d'émission du premier jeton (TTFT) : latence entre la réception d'une requête et l'émission du premier jeton, que ce jeton fasse partie du processus de réflexion du modèle ou de la réponse.
- Délai d'émission de la première réponse (TTFA) : latence entre la réception d'une requête et la diffusion du premier jeton de réponse, qui est le premier jeton ne faisant pas partie du raisonnement du modèle. Si l'agent appelle un outil après avoir commencé à répondre, la mesure redémarre. Ainsi, le TTFA reflète le moment où la réponse lue par l'utilisateur a commencé à être diffusée, et non une narration intermédiaire.
- Délai d'émission du dernier jeton (TTLT) : latence entre la réception d'une requête et la diffusion du dernier jeton, qui correspond à la fin de la réponse.
Filtrer les métriques de latence par fonctionnalité
Une fonctionnalité est le type d'interaction que représente un tour, comme une recherche sur le Web ou une génération d'image. Filtrez les métriques de latence par fonctionnalité pour identifier les types d'interaction les plus lents et éviter qu'une fonctionnalité lente ne fausse votre latence globale.
Pour filtrer les métriques de latence par caractéristique :
- Dans l'onglet Observabilité de l'agent, cliquez sur la vue Latence.
- Cliquez sur Filtrer par fonctionnalité.
- Sélectionnez la caractéristique que vous souhaitez inspecter.
Les fiches de résumé et les graphiques de séries temporelles n'affichent alors que les tours de parole pour cette fonctionnalité.
Pour comparer toutes les fonctionnalités en même temps, utilisez le tableau Télémétrie des fonctionnalités, qui liste les éléments suivants pour chaque fonctionnalité :
- Part de trafic : pourcentage de tours attribués à la fonctionnalité.
- TTFT, TTFA et TTLT : latence p50 et p95 pour la fonctionnalité.
Vous pouvez filtrer les données à l'aide des fonctionnalités suivantes :
- Paramétrique : interactions qui envoient des requêtes au modèle pour obtenir une sortie textuelle uniquement, sans outils, comme les tâches de traduction.
- Génération de contenus multimédias : tâches de génération d'images et de vidéos.
- Recherche sur le Web uniquement : interactions qui envoient des requêtes au modèle à l'aide de l'outil de recherche sur le Web.
- Analyse des fichiers importés : interactions qui envoient des requêtes au modèle en plus des fichiers importés par l'utilisateur.
- Connecteur : requêtes qui envoient des demandes à des connecteurs internes ou tiers.
- Canvas : tâches de génération qui utilisent Canvas.
- Skill : interactions qui appellent un skill.
- Autre : fourre-tout pour les tours qui couvrent plusieurs fonctionnalités ou qui ne sont pas encore classés.

Métriques de taux d'erreur
Cette vue montre comment les requêtes de votre agent sont résolues, regroupées par classe de réponse : OK (2xx), Erreurs client (4xx), Erreurs de serveur (5xx) et Annulées. Il inclut les éléments suivants :
- Volume de requêtes par classe de réponse : nombre de requêtes entrantes au fil du temps, empilées par classe de réponse.
- Taux d'erreur par classe de réponse : pourcentage de requêtes ayant échoué au fil du temps, réparti par classe de réponse.
- Codes d'erreur client (4xx) et Codes d'erreur serveur (5xx) : codes de réponse gRPC canoniques individuels au fil du temps, tels que
INVALID_ARGUMENTouINTERNAL, afin que vous puissiez identifier les erreurs spécifiques à l'origine d'un pic. - Totaux : nombre de requêtes et pourcentage du nombre total de requêtes pour chaque résultat sur la période sélectionnée, avec des tableaux distincts qui classent les codes d'erreur individuels du client et du serveur.

Étapes suivantes
- Créer des tableaux de bord avec les métriques Gemini Enterprise Pour en savoir plus, consultez Créer et gérer des tableaux de bord personnalisés.
- Créez des alertes lorsque les métriques dépassent un seuil. Pour plus d'informations, consultez Créer des règles d'alerte basées sur un seuil de métrique.
- Pour désactiver le suivi de l'Explorateur de métriques, consultez Désactiver les paramètres d'observabilité.