Ce document explique comment accéder aux traces et aux spans générés par votre application Gemini Enterprise et les afficher. Les traces et les spans fournissent des informations détaillées sur les performances et le flux d'exécution des requêtes dans votre application, par exemple lorsque vous utilisez l'assistant ou les agents.
Vous pouvez afficher les données de trace à l'aide de l'explorateur de traces ou directement dans les agents individuels à l'aide de l'onglet Traces de l'agent.
Concepts clés
Cette section présente les concepts clés liés à l'observabilité dans Gemini Enterprise.
| Concept | Description |
|---|---|
| Trace |
Une trace est un ensemble de spans qui représente une seule requête ou transaction lorsqu'elle transite par différents services et composants.
Par exemple, une trace représente l'ensemble du cycle de vie d'une requête. Cela inclut une question posée par un utilisateur à l'assistant Gemini Enterprise, la réponse de l'assistant Gemini Enterprise et toutes les actions ultérieures déclenchées par la réponse, comme l'envoi d'un e-mail. |
| Segment | Un segment est une unité de travail unique et chronométrée dans une trace. Elle représente une opération spécifique, telle qu'un appel de fonction, une requête API ou une requête de base de données. Chaque span inclut des informations telles que ses heures de début et de fin, un ID unique et sa relation avec d'autres spans. Ces relations forment ensemble une trace. |
| Journaux de spans | Les journaux de portée sont des messages ou des événements horodatés et de forme libre associés à une portée spécifique. Elles fournissent des informations contextuelles détaillées sur l'exécution d'une étendue, ce qui aide les utilisateurs à déboguer les problèmes et à comprendre le flux d'une requête. |
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 savoir comment créer une application, consultez Créer une application.
Pour accéder aux traces, vous devez disposer du rôle Utilisateur Cloud Trace (
roles/cloudtrace.user).Activez le paramètre d'observabilité Activer l'instrumentation des traces et des journaux OpenTelemetry. Selon le type d'agent, vous pouvez activer cette option dans les configurations au niveau de l'application (pour l'agent Assistant principal) ou dans l'onglet Configuration de l'agent (pour les agents Agent Designer créés par les employés et les agents Recherche approfondie). Pour en savoir plus, consultez Gérer les paramètres d'observabilité.
Conservation des données
Les traces et les spans générés par votre application Gemini Enterprise sont stockés dans Cloud Trace dans votre projet Google Cloud . Leur durée de conservation est régie par Cloud Trace. Par défaut, Cloud Trace conserve les données de span pendant 30 jours. Les données plus anciennes que la période de conservation sont automatiquement supprimées. Pour obtenir les valeurs de conservation les plus récentes et faisant autorité, consultez Durées de conservation de Cloud Trace dans la documentation Quotas et limites de Cloud Trace.
Accéder aux traces dans l'explorateur Trace
Pour accéder aux traces et aux spans à l'aide de l'explorateur de traces, procédez comme suit :
Dans la console Google Cloud , accédez à la page Explorateur Trace.
Sélectionnez le projet Google Cloud dans lequel votre application Gemini Enterprise a été créée. Vous voyez toutes les portées de votre projet.
Dans le tableau, cliquez sur un ID de segment pour afficher les détails de la trace, y compris la durée du segment et d'autres attributs.
Accéder aux traces pour les agents
Vous pouvez également afficher directement les étendues de trace pour chaque agent dans l'onglet Traces de l'agent. Cet onglet affiche un récapitulatif chronologique détaillé des enregistrements de trace d'étendue et des structures d'exécution parent-enfant.
Pour accéder aux traces 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 Traces.
Tableau récapitulatif des traces
Le tableau principal de l'onglet Traces affiche les informations suivantes pour chaque span de trace :
- État : état actuel de la trace (Non défini s'affiche actuellement).
- ID du segment de trace : identifiant unique du segment de trace. Cliquez sur le lien de l'ID de span pour afficher ses détails.
- Nom du segment : brève description du travail effectué par le segment.
- Type de segment : type de segment. Voici quelques exemples d'options :
Agent to Tool: appel d'un agent à un outil externe.Invoke Agent: appel d'un agent.Agent to Model: requête de l'agent à un grand modèle de langage.
- Durée : temps nécessaire pour terminer le segment de trace (en minutes).
- Entrée : données ou message d'entrée envoyés au segment, le cas échéant.
- Sortie : résultat de sortie renvoyé par la portée, le cas échéant.
- Heure de début : code temporel exact du début de l'exécution de la portée.
Vue détaillée des traces
Si vous cliquez sur un ID de span de trace, une page détaillée s'ouvre et affiche les informations suivantes :
- Récapitulatif : affichez les métadonnées de référence, y compris l'heure de début, la durée et le nombre total d'étendues. Vous pouvez cliquer sur Afficher dans Cloud Trace ou basculer entre les boutons d'affichage Graphique et Chronologie.
- Visualisations : basculez entre une hiérarchie graphique et une vue chronologique montrant les relations parent-enfant de toutes les étendues de trace.
- Détails de la plage sélectionnée : sélectionnez une seule plage pour afficher des sections détaillées, qui peuvent inclure :
- Récapitulatif : affiche le nom du span, le service cible, le nombre total de spans avec cette action et la durée totale (en secondes).
- Journaux : affichez les détails des événements pertinents, le cas échéant. Cliquez sur Afficher les journaux pour accéder directement aux journaux standards.
- Évaluation : affiche les résultats de l'évaluation, le cas échéant.
- Entrée et sortie : charge utile complète de la requête et de la réponse.
- Journaux et événements : liste des événements qui se sont produits lors de l'exécution de ce segment.
- Traces de pile : détails de l'erreur en cas d'échec de l'exécution d'un segment.
- Métadonnées et liens : liens vers des entités associées de l'explorateur cloud.
- Attributs : balises de ressources et paramètres d'observabilité clé/valeur supplémentaires.
