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 des 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 à l'échelle de l'agent | Métriques qui mesurent l'activité d'un agent individuel, comme ses sessions, ses tours de conversation et ses appels d'outils. Elles sont listées sous le type de ressource Gemini Enterprise Agent 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 à l'échelle de l'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 d'une application Gemini Enterprise, et 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 d'administrateur Gemini Enterprise ou le rôle d'utilisateur Gemini Enterprise dans la Google Cloud console.
Une application Web Gemini Enterprise existante. Pour en savoir plus sur la création d'une nouvelle 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-le 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 d'Agent Designer et les agents Deep Research). Pour en savoir plus, consultez Gérer les paramètres d'observabilité. Ce paramètre est requis pour les métriques à l'échelle de l'agent. Les métriques à l'échelle de l'application, qui sont listées sous le type de ressource Moteur Gemini Enterprise, sont collectées sans ce paramètre.
Conservation des données
Les métriques générées par votre application Gemini Enterprise sont stockées dans
Cloud Monitoring dans votre Google Cloud projet, et leur conservation est régie
par Cloud Monitoring. Les métriques Gemini Enterprise sont publiées sous le
discoveryengine.googleapis.com/ préfixe, qui relève du niveau "Toutes les autres
Google Cloud métriques" et est conservé pendant six semaines par défaut. Les données antérieures à la période de conservation sont automatiquement supprimées. Pour obtenir les valeurs de conservation faisant autorité
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 Google Cloud console, accédez à la page Explorateur de métriques.
Sélectionnez le Google Cloud projet 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 - Nombre de sessions de l'agent Gemini Enterprise Nombre de sessions gérées par l'agent Gemini Enterprise. Gemini Enterprise Agent - Nombre d'outils de l'agent Gemini Enterprise Nombre de fois où des outils ont été appelés par l'agent Gemini Enterprise. Gemini Enterprise Agent - Nombre de tours de l'agent Gemini Enterprise Nombre de tours de conversation dans les sessions de l'agent Gemini Enterprise. Gemini Enterprise Agent - Latence totale de l'agent Gemini Enterprise Latence totale des réponses de l'agent Gemini Enterprise. Gemini Enterprise Agent - Latence totale des outils de l'agent Gemini Enterprise Latence totale générée par les exécutions d'outils dans l' agent Gemini Enterprise. Gemini Enterprise DataConnector - Nombre de requêtes du connecteur de données Gemini Enterprise Nombre total de requêtes adressées aux connecteurs de données Gemini Enterprise (également appelés datastores dans la Google Cloud console). Gemini Enterprise DataConnector - 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 Google Cloud console) en millisecondes. Gemini Enterprise Engine - Nombre de requêtes du moteur Gemini Enterprise Nombre total de requêtes reçues par votre application Gemini Enterprise, pour 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. Gemini Enterprise Engine - 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. Gemini Enterprise Engine - Latence avant la première réponse du moteur Gemini Enterprise Distribution de la latence entre la réception d'une requête et la diffusion en flux continu du premier jeton de réponse. Enregistrée uniquement pour les requêtes qui génèrent au moins un jeton de réponse. Gemini Enterprise Engine - Latence avant le premier jeton du moteur Gemini Enterprise Distribution de la latence entre la réception d'une requête et la diffusion en flux continu du premier jeton, que ce jeton fasse partie du processus de réflexion du modèle ou qu'il s'agisse d'une réponse finale. Enregistrée uniquement pour les requêtes qui génèrent au moins un jeton diffusé en flux continu. 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 des agents
Vous pouvez également afficher des tableaux de bord de métriques opérationnelles, spécifiques aux outils et de session directement pour des agents individuels dans l'onglet Observabilité de l'agent dans la Google Cloud console.
Pour accéder aux métriques d'un agent :
- Dans la Google Cloud console, 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 deux vues : Présentation et Outils.
Métriques générales
Cette vue fournit un tableau de bord récapitulatif des données standards sur l'état des sessions et des agents, qui incluent les éléments suivants :
- Sessions : nombre total de sessions utilisateur.
- Durée moyenne par session : durée moyenne écoulée lors d'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, qui incluent les éléments suivants :
- Nombre total d'appels : nombre de requêtes d'exécution d'outils.
- Durée P95 par outil : 95e centile de latence des exécutions, classé par outil.
- Nombre d'appels par outil : nombre total d'appels divisé entre différents outils.
- Taux d'erreur par outil : taux d'échec des exécutions par outil.
- Taux"Aucun outil appelé" : taux auquel les interactions n'ont déclenché aucune exécution d'outil.
Étape suivante
- Créez 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 en savoir plus, 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é.