Cette page a été traduite par l'API Cloud Translation.

Rechercher et explorer des traces

Pour afficher une représentation globale de vos données de trace, ou pour rechercher et explorer des traces individuelles ou des traces contenant des libellés spécifiques, utilisez la page Explorateur de traces.

Cette fonctionnalité n'est disponible que pour les projets Google Cloud.

À propos de la page Explorateur Trace

Pour vous aider à identifier les tendances et les schémas dans vos données de trace, les données de latence sont agrégées et affichées dans des graphiques. La carte de densité, qui est la visualisation par défaut, utilise la couleur pour représenter le nombre de portées dans une cellule. Une cellule contenant de nombreuses plages est affichée avec une couleur plus foncée qu'une cellule contenant peu de plages. Vous pouvez sélectionner une cellule ou activer son info-bulle pour obtenir plus d'informations. Les autres visualisations vous permettent d'afficher la latence sous forme de centile et d'informations sur la plage de taux. Pour toutes les visualisations, vous pouvez utiliser le pointeur pour développer l'axe des abscisses. Pour les graphiques en courbes, vous pouvez développer les axes des abscisses et des ordonnées.

Lorsque vous examinez un problème, vous pouvez afficher une trace spécifique ou uniquement des segments avec certaines propriétés:

Lorsque vous connaissez l'ID d'une trace, dans la barre d'outils, cliquez sur Search for trace (Rechercher une trace), puis saisissez l'ID de la trace dans la boîte de dialogue. Vous pouvez ensuite rechercher des mots clés dans les plages et les attributs de la trace .
Lorsque vous consultez les données agrégées, vous pouvez rechercher des périodes spécifiques en appliquant des filtres. Par exemple, vous pouvez filtrer les données pour n'afficher que les plages d'un service spécifique. Vous pouvez ensuite ajouter un deuxième filtre qui limite l'affichage aux plages pour un service spécifique qui signale une erreur.

Les données tabulaires vous permettent d'afficher les détails de chaque intervalle et de repérer les valeurs aberrantes. Par exemple, pour trouver la période ayant la valeur de latence la plus élevée, sélectionnez l'onglet Périodes, puis triez les données par latence. Pour trouver les services qui génèrent des erreurs, filtrez les données par état de la période, puis sélectionnez l'onglet Groupé, qui affiche les données agrégées par période et par nom de service. Chaque ligne du tableau contient un lien vers des informations détaillées.

Les données de trace affichées par la page Explorateur de traces dépendent des éléments suivants:

Projets pour lesquels des données de trace ont été recherchées. Par défaut, seules les données de trace du projet sélectionné par l'outil de sélection de projets sont recherchées. Toutefois, vous pouvez configurer la page pour rechercher dans la liste des projets d'un champ d'application de trace.
Vos autorisations IAM (Identity and Access Management) sur les projets recherchés. Si vous n'êtes pas autorisé à afficher les données de trace d'un projet, la console Google Cloud affiche un message d'avertissement et les données de ce projet ne s'affichent pas.
Paramètre de la période.
Les filtres que vous appliquez

Le reste de cette page fournit plus d'informations sur la façon de trouver et d'explorer vos données de trace.

Avant de commencer

Pour obtenir les autorisations nécessaires pour afficher les données de trace à l'aide de la console Google Cloud et pour sélectionner un champ d'application de trace, demandez à votre administrateur de vous accorder le rôle IAM Utilisateur Cloud Trace (roles/cloudtrace.user) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour afficher les données de trace à l'aide de la console Google Cloud et pour sélectionner un champ d'application de trace. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Vous devez disposer des autorisations suivantes pour afficher les données de trace à l'aide de la console Google Cloud et pour sélectionner un champ d'application de la trace:

Pour sélectionner la portée d'une trace : cloudtrace.traceScopes.[get, list]
Pour lire le champ d'application de la trace par défaut : observability.scopes.get

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour en savoir plus sur les rôles, consultez la section Contrôler les accès avec Identity and Access Management.

Afficher les données de trace agrégées

Pour afficher les informations agrégées sur vos données de trace, procédez comme suit:

Dans la console Google Cloud, accédez à la page Explorateur Trace.
Accéder à Explorateur Trace

Vous pouvez également accéder à cette page à l'aide de la barre de recherche.

L'affichage des premières données de trace dans un projet Google Cloud peut prendre plusieurs minutes. Si aucune donnée de trace ne s'affiche après quelques minutes d'attente, il est possible que votre projet ne dispose d'aucune donnée à afficher ou qu'il y ait un problème de configuration. Pour en savoir plus sur la résolution de ces problèmes, consultez la section Dépannage: Aucune donnée dans l'interface Trace.
Dans la barre d'outils de la console Google Cloud, sélectionnez votre projet Google Cloud.
Facultatif: Configurez les projets pour lesquels des données de trace sont recherchées à l'aide de l'élément Champ d'application:
- Pour afficher les données de trace stockées dans votre projet, définissez le premier menu de l'élément Champ d'application sur Projet ou _Par défaut. Ces deux paramètres sont équivalents.
- Pour afficher les données de trace stockées dans plusieurs projets, développez le premier menu de l'élément Champ d'application, sélectionnez Champ d'application de la trace, puis sélectionnez le champ d'application de la trace qui liste ces projets. Une fois votre sélection effectuée, le menu Champ d'application affiche une icône de champ d'application de trace, , et le nom du champ d'application de trace sélectionné.
Les données renvoyées dépendent de vos rôles IAM sur les projets recherchés. Par exemple, si les projets recherchés incluent un projet Google Cloud auquel vous n'avez pas accès, aucune donnée de trace pour ce projet n'est renvoyée.

Pour en savoir plus, consultez la section Créer et gérer des champs d'action de trace.
Facultatif: Modifiez la période à l'aide du sélecteur de période ou en utilisant le pointeur pour mettre en évidence une plage sur l'axe X.
Explorez les graphiques, qui affichent les tendances et les caractéristiques de vos données de trace:
- Pour obtenir des informations sur les données de latence des segments, définissez le menu Vue du graphique sur Durée du segment (carte de densité). L'intensité de la couleur est proportionnelle au nombre de portées. Pour obtenir des informations sur une cellule, utilisez votre pointeur. L'info-bulle affiche le nombre de périodes, la date et l'heure, ainsi que l'intervalle de temps de la cellule.
  
  Remarque :Si vous sélectionnez une cellule dans la carte de densité, le tableau qui liste les plages individuelles ou les regroupements de plages est mis à jour.
- Pour afficher les tendances de latence, définissez le menu Vue du graphique sur Durée de la période (centile). Le graphique de la durée affiche les 50e, 90e, 95e et 99e centiles.
- Pour afficher l'état de la réponse en fonction du temps, définissez le menu Vue du graphique sur Taux de plage. Le graphique affiche le nombre de portées envoyées à votre projet.
Explorez les données tabulaires qui répertorient les segments individuels dans l'onglet Segments et les segments regroupés par service et par nom dans l'onglet Groupé.

Chaque ligne des tableaux affiche une période ou un regroupement, ainsi qu'un lien vers des informations détaillées et certaines métriques. Par exemple, dans l'onglet Groupé, les métriques incluent le taux d'erreur et le nombre de périodes du groupe.

Pour trouver des valeurs aberrantes, sélectionnez un en-tête de colonne pour trier le tableau.
Ajoutez des filtres pour limiter les segments affichés. Par exemple, vous pouvez filtrer par nom de service et par état. Lorsque vous ajoutez ou supprimez un filtre, les données affichées par la page Explorateur Trace sont actualisées et n'affichent que les plages correspondant à tous les filtres appliqués.

Pour modifier les paramètres de vos filtres, procédez comme suit:
- Accédez au volet Filtres de période, puis sélectionnez les filtres à appliquer.
  
  Le volet Filtres de période ne liste que les filtres les plus courants. Si vous souhaitez filtrer par un attribut qui ne figure pas dans la liste, utilisez la barre Filtrer.
- Pour ajouter un filtre à l'aide de la barre Filtre, sélectionnez Ajouter un filtre, puis remplissez la boîte de dialogue.
  
  Pour filtrer par un attribut qui ne figure pas dans le menu des options, sélectionnez Ajouter un filtre d'attribut, puis ajoutez votre clé et votre valeur personnalisées. Par exemple, si vous définissez la clé sur /http/status_code et la valeur sur 200, le filtre est /http/status_code: 200. Pour que le filtre corresponde à n'importe quelle valeur, sélectionnez Toute valeur.

Trouver une trace par ID

Lorsque vous dépannez un incident ou une défaillance, vous pouvez connaître l'ID de trace. Pour explorer cette trace, procédez comme suit:

Dans la console Google Cloud, accédez à la page Explorateur Trace.
Accéder à Explorateur Trace

Vous pouvez également accéder à cette page à l'aide de la barre de recherche.
Dans la barre d'outils de la console Google Cloud, sélectionnez votre projet Google Cloud.
Accédez à la barre d'outils, cliquez sur Search for trace (Rechercher une trace), puis saisissez l'ID de la trace.

Lorsque vous saisissez un ID valide, le volet Détails s'ouvre et affiche des informations sur la trace et ses délais. Vous pouvez utiliser les options de ce volet pour explorer la trace. Par exemple, vous pouvez rechercher des mots clés dans les plages.

Remarque :Si vous saisissez un ID de trace qui n'est pas trouvé, les données de trace peuvent être stockées dans un projet qui n'est pas recherché par la page Explorateur de traces, ou vous ne disposez peut-être pas d'un rôle IAM vous permettant d'afficher les données de trace. Pour résoudre ces échecs, identifiez les projets qui stockent les données de trace. Pour chaque projet, vérifiez que votre rôle IAM vous permet d'afficher les données de trace, puis assurez-vous que l'élément Champ d'application est configuré pour rechercher tous les projets qui stockent vos données de trace. Pour en savoir plus, consultez la section Mettre à jour la liste des projets pour lesquels des données de trace sont recherchées.

Explorer une trace

Pour afficher une trace ou un segment, procédez comme suit:

Dans la console Google Cloud, accédez à la page Explorateur Trace.
Accéder à Explorateur Trace

Vous pouvez également accéder à cette page à l'aide de la barre de recherche.

L'affichage des premières données de trace dans un projet Google Cloud peut prendre plusieurs minutes. Si aucune donnée de trace ne s'affiche après quelques minutes d'attente, il est possible que votre projet ne dispose d'aucune donnée à afficher ou qu'il y ait un problème de configuration. Pour en savoir plus sur la résolution de ces problèmes, consultez la section Dépannage: Aucune donnée dans l'interface Trace.
Dans la barre d'outils de la console Google Cloud, sélectionnez votre projet Google Cloud.
Effectuez l'une des opérations suivantes :
- Accédez à la section du tableau de la page Trace Explorer, puis sélectionnez une entrée du tableau qui liste des segments ou des informations récapitulatives après avoir regroupé les données par service et par nom de segment.
- Accédez à la barre d'outils de la page Explorateur Trace, cliquez sur Search for trace (Rechercher une trace), puis saisissez l'ID de trace.
Le panneau volant Details (Détails) s'ouvre et affiche une trace et ses délais:
- La colonne Nom affiche la hiérarchie des appels, et la première entrée inclut l'ID de trace.
- La colonne Service est extraite de l'attribut OpenTelemetry service.name, lorsque cet attribut est défini. Si cet attribut n'est pas défini et que le service est en cours d'exécution sur App Engine, le nom du service App Engine s'affiche. Sinon, aucun service n'est spécifié.
- La longueur de la barre de latence représente la valeur de latence.
- La couleur de la barre de latence indique l'état. Une barre de latence bleue indique une réussite, tandis qu'une barre de latence rouge indique qu'une erreur s'est produite.
- Un cercle sur une barre de latence indique qu'une entrée de journal ou un événement est associé à la période. Pour modifier ce comportement, utilisez le menu Journaux et événements.
Facultatif: recherchez le nom de la période, le nom du service et les attributs dans une trace à l'aide du champ Find in Trace (Rechercher dans la trace).

Par exemple, si vous saisissez GET, le texte du nom du segment, du nom du service ou du volet Attributs qui affiche GET, sans tenir compte de la casse, est mis en surbrillance.

Vous ne pouvez pas effectuer de recherche à l'aide d'une expression régulière, ni rechercher des journaux, des événements ou des métadonnées.
Pour afficher les détails d'une période spécifique, sélectionnez-la, puis affichez ses attributs et ses événements. Pour en savoir plus, consultez la section suivante.

Afficher les attributs et les événements

Cette section explique comment afficher les libellés, les journaux et les événements.

Afficher les étiquettes

Pour afficher les libellés associés au segment, accédez à l'onglet Attributs. Pour en savoir plus sur les libellés, consultez Libellés de trace.

Afficher les journaux et les événements

Pour afficher les journaux et les événements associés au segment, accédez à l'onglet Logs & Events (Journaux et événements). Pour en savoir plus sur les annotations d'événements, consultez la section Annoter des délais de trace.

Pour afficher une entrée de journal, cliquez sur Plus.

Vous pouvez également sélectionner le bouton Afficher les journaux, qui ouvre la page de l'explorateur de journaux avec la requête définie pour filtrer sur une trace, une période et une plage temporelle spécifiques. Il se peut que cette requête ne renvoie aucune entrée de journal.

Afficher les événements d'IA générative

Pour afficher les événements liés aux agents d'IA générative, utilisez l'onglet GenAI. Cet onglet est disponible lorsque les délais envoyés à Trace respectent les conventions sémantiques OpenTelemetry pour les systèmes d'IA générative, ce qui génère des messages dont le nom commence par gen_ai.

Les attributs sont des paires clé-valeur qui décrivent une caractéristique. Voici des exemples d'attributs d'un système d'IA générative:

gen_ai.system: identifie le système qui fournit les fonctionnalités d'IA générative.
gen_ai.request.model: identifie le modèle auquel la requête est envoyée.

Les événements dont le nom commence par "gen_ai" décrivent généralement des entrées ou des sorties individuelles d'un système d'IA générative. Ces entrées et sorties incluent les requêtes système et utilisateur, les entrées et sorties de l'outil, ainsi que les réponses du modèle. Voici des exemples d'événements d'un système d'IA générative:

gen_ai.system.message: événement enregistrant l'invite système envoyée à un modèle d'IA générative. L'invite système fournit au modèle des instructions qui ne sont généralement pas visibles par l'utilisateur final et qui guident l'interprétation du modèle de l'invite de l'utilisateur.
gen_ai.user.message: événement enregistrant la requête fournie par l'utilisateur qui a été envoyée au modèle.
gen_ai.assistant.message: événement enregistrant la sortie du modèle, qui peut inclure l'enregistrement d'une invocation d'outil ou qui peut contenir une sortie de réponse textuelle. Un message peut inclure des réponses candidates qui ne sont pas utilisées par l'application.
gen_ai.choice: événement utilisé pour indiquer les sorties candidates utilisées par l'application.

Afficher les traces de la pile

Pour afficher les traces de la pile, utilisez l'onglet Traces de la pile.

Afficher des informations générales et d'autres métadonnées

Pour obtenir des informations générales sur la période et un tableau de liens vers d'autres périodes, consultez l'onglet Métadonnées et liens. Ces informations incluent les éléments suivants:

ID de span: l'ID de span est un entier de 64 bits autre que 0. Pour en savoir plus, consultez TraceSpan.
ID de segment parent
ID du projet
Heures de début et de fin
Tableau répertoriant les liens vers d'autres segments

Chaque ligne du tableau intitulé Liens liste un lien entre le délai actuel et un autre délai. Le champ Attributs liste les paires clé-valeur pour la portée associée. Le champ Trace renvoie vers la trace du segment associé. Lorsque ce champ contient Trace actuelle, la portée associée se trouve dans la même trace que la portée actuelle. Sinon, le champ contient un ID de trace. Pour en savoir plus sur les associations, consultez la page de référence de l'API Links.