Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Affichage des traces et des détails des traces
Utilisez la page Traces de la X-Ray console pour rechercher des traces par URL, code de réponse ou autres données à partir du résumé des traces. Après avoir sélectionné une trace dans la liste des traces, la page Détails de la trace affiche une carte des nœuds de service associés à la trace sélectionnée et une chronologie des segments de trace.
Affichage des suivis
- CloudWatch console
-
Pour afficher les traces dans la CloudWatch console
Connectez-vous à Console de gestion AWS et ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.
-
Dans le volet de navigation de gauche, choisissez X-Ray traces, puis choisissez Traces. Vous pouvez filtrer par groupe ou saisir une expression de filtre. Cela filtre les traces affichées dans la section Traces en bas de la page.
Vous pouvez également utiliser la carte des services pour accéder à un nœud de service spécifique, puis afficher les traces. Cela ouvre la page Traces avec une requête déjà appliquée.
-
Affinez votre requête dans la section Affineurs de requêtes. Pour filtrer les traces selon un attribut commun, choisissez une option dans la flèche vers le bas à côté de Affiner la requête par. Les options disponibles sont les suivantes :
-
Nœud : filtrez les traces par nœud de service.
-
ARN de ressource : filtrez les traces en fonction d'une ressource associée à une trace. Parmi ces ressources, citons une instance Amazon Elastic Compute Cloud (Amazon EC2), une AWS Lambda
fonction ou une Amazon DynamoDB table.
-
Utilisateur : filtrez les traces à l'aide d'un identifiant utilisateur.
-
Message sur la cause première de l'erreur : filtrez les traces en fonction de la cause première de l'erreur.
-
URL : filtrez les traces en fonction du chemin URL utilisé par votre application.
-
Code d'état HTTP : filtrez les traces en fonction du code d'état HTTP renvoyé par votre application. Vous pouvez spécifier un code de réponse personnalisé ou sélectionner l'une des options suivantes :
-
200— La demande a été acceptée.
-
401— La demande ne comportait pas d'informations d'authentification valides.
-
403— La demande ne disposait pas d'autorisations valides.
-
404— Le serveur n'a pas pu trouver la ressource demandée.
-
500— Le serveur a rencontré une situation inattendue et a généré une erreur interne.
Choisissez une ou plusieurs entrées, puis choisissez Ajouter à la requête pour l'ajouter à l'expression de filtre en haut de la page.
-
Pour rechercher une seule trace, entrez un identifiant de trace directement dans le champ de requête. Vous pouvez utiliser le X-Ray format ou le format World Wide Web Consortium (W3C). Par exemple, une trace créée à l'aide de AWS Distro for OpenTelemetry est au format W3C.
Lorsque vous interrogez des traces créées avec un ID de W3C-format trace, la console affiche la trace correspondante au X-Ray format. Par exemple, si vous effectuez une requête 4efaaf4d1e8720b39541901950019ee5 au format W3C, la console affiche l' X-Ray équivalent :1-4efaaf4d-1e8720b39541901950019ee5.
-
Choisissez Exécuter la requête à tout moment pour afficher la liste des traces correspondantes dans la section Traces au bas de la page.
-
Pour afficher la page des détails de la trace pour une seule trace, sélectionnez un ID de trace dans la liste.
L'image suivante montre une carte de trace contenant des nœuds de service associés à la trace et des arêtes entre les nœuds représentant le chemin emprunté par les segments qui composent la trace. Un résumé de la trace suit la carte de trace. Le résumé contient des informations sur un exemple d'GETopération, son code de réponse, la durée d'exécution du traçage et l'âge de la demande. La chronologie des segments suit le résumé des traces qui indique la durée des segments et des sous-segments de trace.
Si vous disposez d'une application événementielle qui utilise Amazon SQS et Lambda, vous pouvez voir une vue connectée des traces pour chaque demande dans la carte des traces. Sur la carte, les traces des producteurs de messages sont liées aux traces des AWS Lambda consommateurs et sont affichées sous forme de lignes pointillées. Pour plus d'informations sur les applications pilotées par les événements, consultez. Suivi des applications pilotées par des événements
Les pages de détails des traces et des traces prennent également en charge le suivi intercomptes, qui peut répertorier les traces de plusieurs comptes dans la liste des traces et dans une seule carte de trace.
- X-Ray console
-
Pour afficher les traces dans la X-Ray console
-
Ouvrez la page Traces dans la X-Ray console. Le panneau de présentation des traces affiche une liste de traces regroupées selon des caractéristiques communes, notamment Error root causes, ResourceArn et. InstanceId
-
Pour sélectionner une fonction commune permettant d'afficher un ensemble de traces groupées, développez la flèche vers le bas à côté de Regrouper par. L'illustration suivante présente un aperçu des traces regroupées par URL pour leAWS X-Ray exemple d'application, ainsi qu'une liste des traces associées.
-
Choisissez l'ID d'une trace pour l'afficher dans la liste des traces. Vous pouvez également choisir Carte des services dans le volet de navigation pour afficher les traces d'un nœud de service spécifique. Vous pouvez ensuite afficher les traces associées à ce nœud.
L'onglet Chronologie affiche le flux de demande pour la trace et inclut les éléments suivants :
-
Une carte de la trajectoire pour chaque segment de la trace.
-
Combien de temps a-t-il fallu au segment pour atteindre un nœud de la carte de traçage.
-
Combien de demandes ont été adressées au nœud dans la carte de trace.
L'illustration suivante montre un exemple de Trace Map associé à une GET demande adressée à un exemple d'application. Les flèches indiquent le chemin emprunté par chaque segment pour terminer la demande. Les nœuds de service indiquent le nombre de demandes effectuées lors de la GET demande.
Pour plus d'informations sur l'onglet Chronologie, consultez la section Exploration de la chronologie de suivi suivante.
L'onglet Données brutes affiche des informations sur la trace, ainsi que sur les segments et sous-segments qui la composent, au JSON format. Ces informations peuvent inclure les informations suivantes :
-
Horodatages
-
ID uniques
-
Ressources associées au segment ou au sous-segment
-
La source ou l'origine du segment ou du sous-segment
-
Informations supplémentaires sur la demande adressée à votre application, telles que la réponse à une requête HTTP
Exploration de la chronologie des traces
La section Chronologie présente une hiérarchie de segments et de sous-segments à côté d'une barre horizontale qui correspond au temps qu'ils ont utilisé pour accomplir leurs tâches. La première entrée de la liste est le segment, qui représente toutes les données enregistrées par le service pour une seule demande. Les sous-segments sont indentés et répertoriés à la suite du segment. Les colonnes contiennent des informations sur chaque segment.
- CloudWatch console
-
Dans la CloudWatch console, la chronologie des segments fournit les informations suivantes :
-
La première colonne : répertorie les segments et sous-segments de la trace sélectionnée.
-
La colonne État du segment : répertorie le résultat de l'état de chaque segment et sous-segment.
-
La colonne Code de réponse : répertorie un code d'état de réponse HTTP à une demande de navigateur effectuée par le segment ou le sous-segment, lorsqu'il est disponible.
-
La colonne Durée : répertorie la durée du segment ou du sous-segment.
-
La colonne Hébergé dans : répertorie l'espace de noms ou l'environnement dans lequel le segment ou le sous-segment est exécuté, le cas échéant. Pour plus d'informations, voir Dimensions collectées et combinaisons de dimensions.
-
La dernière colonne : affiche des barres horizontales qui correspondent à la durée d'exécution du segment ou du sous-segment, par rapport aux autres segments ou sous-segments de la chronologie.
Pour regrouper la liste des segments et des sous-segments par nœud de service, activez Regrouper par nœuds.
- X-Ray console
-
Sur la page des détails de la trace, choisissez l'onglet Chronologie pour voir la chronologie de chaque segment et sous-segment constituant une trace.
Dans la X-Ray console, la chronologie fournit les informations suivantes :
-
La colonne Nom : répertorie les noms des segments et des sous-segments de la trace.
-
La colonne Res. : répertorie un code d'état de réponse HTTP à une demande de navigateur effectuée par le segment ou le sous-segment, lorsqu'il est disponible.
-
La colonne Durée : répertorie la durée du segment ou du sous-segment.
-
La colonne État : répertorie le résultat de l'état du segment ou du sous-segment.
-
La dernière colonne : affiche des barres horizontales qui correspondent à la durée d'exécution du segment ou du sous-segment, par rapport aux autres segments ou sous-segments de la chronologie.
Pour voir les données de trace brutes que la console utilise pour générer la chronologie, choisissez l'onglet Données brutes. Les données brutes vous fournissent des informations sur la trace, ainsi que sur les segments et sous-segments qui composent la trace au JSON format. Ces informations peuvent inclure les informations suivantes :
-
Horodatages
-
ID uniques
-
Ressources associées au segment ou au sous-segment
-
La source ou l'origine du segment ou du sous-segment
-
Informations supplémentaires sur la demande adressée à votre application, telles que la réponse à une requête HTTP.
Lorsque vous utilisez un AWS SDK instrumenté ou un SQL client pour appeler des ressources externes, le X-Ray SDK enregistre automatiquement les sous-segments. HTTP Vous pouvez également utiliser le X-Ray SDK pour enregistrer des sous-segments personnalisés pour n'importe quelle fonction ou bloc de code. Les sous-segments supplémentaires enregistrés alors qu'un sous-segment personnalisé est ouvert deviennent les enfants du sous-segment personnalisé.
Affichage des détails d'un segment
Dans la chronologie du suivi, choisissez le nom d'un segment pour en afficher les détails.
Le panneau des détails du segment affiche les onglets Vue d'ensemble , Ressources, Annotations, Métadonnées , Exceptions et SQL. Les conditions suivantes s'appliquent :
-
L’onglet Overview (Présentation) présente les informations relatives à la demande et à la réponse. Les informations incluent le nom, l'heure de début, l'heure de fin, la durée, l'URL de la demande, le fonctionnement de la demande, le code de réponse à la demande et les éventuelles erreurs et défauts.
-
L'onglet Ressources d'un segment affiche des informations provenant du X-Ray SDK et relatives aux AWS ressources qui exécutent votre application. Utilisez les plug-ins Amazon EC2 ou Amazon ECS pour le X-Ray SDK afin d'enregistrer des informations sur les ressources spécifiques au service. AWS Elastic Beanstalk Pour plus d'informations sur les plugins, consultez la section Plug-ins de service dansConfiguration du SDK X-Ray pour Java.
-
Les autres onglets présentent les annotations , les métadonnées et les exceptions enregistrées pour le segment. Les exceptions sont capturées automatiquement lorsqu'elles sont générées à partir d'une demande instrumentée. Les annotations et les métadonnées contiennent des informations supplémentaires que vous enregistrez à l'aide des opérations fournies par le X-Ray SDK. Pour ajouter des annotations ou des métadonnées à vos segments, utilisez le X-Ray SDK. Pour plus d'informations, consultez le lien spécifique à la langue répertorié sous Instrumentation de votre application à l'aide AWS X-Ray de SDK intégrés. Instrumentation de votre application pour AWS X-Ray
Affichage des détails d'un sous-segment
Dans la chronologie du suivi, choisissez le nom d'un sous-segment pour en afficher les détails :
-
L'onglet Aperçu contient des informations sur la demande et la réponse. Cela inclut le nom, l'heure de début, l'heure de fin, la durée, la demandeURL, le fonctionnement de la demande, le code de réponse à la demande et les éventuelles erreurs et défauts. Pour les sous-segments générés avec des clients instrumentés, l’onglet Overview (Présentation) contient des informations sur la demande et la réponse du point de vue de votre application.
-
L'onglet Ressources d'un sous-segment affiche des informations sur les AWS
ressources qui ont été utilisées pour exécuter le sous-segment. Par exemple, l'onglet Ressources peut inclure un ARN de AWS Lambda fonction, des informations sur une table DynamoDB, toute opération appelée et un ID de demande.
-
Les autres onglets présentent les annotations, les métadonnées et les exceptions enregistrées sur le sous-segment. Les exceptions sont capturées automatiquement lorsqu'elles sont générées à partir d'une demande instrumentée. Les annotations et les métadonnées contiennent des informations supplémentaires que vous enregistrez à l'aide des opérations fournies par le X-Ray SDK. Utilisez le X-Ray SDK pour ajouter des annotations ou des métadonnées à vos segments. Pour plus d'informations, consultez le lien spécifique à la langue répertorié sous Instrumentation de votre application à l'aide AWS X-Ray
de SDK intégrés. Instrumentation de votre application pour AWS X-Ray
Pour les sous-segments personnalisés, l’onglet Overview (Présentation) affiche le nom du sous-segment, que vous pouvez définir pour spécifier la zone de code ou la fonction que celui-ci enregistre. Pour plus d'informations, consultez le lien spécifique à la langue répertorié sous Instrumentation de votre application à l'aide AWS X-Ray de SDK intégrés. Génération de sous-segments personnalisés avec le X-Ray SDK for Java
L'image suivante montre l'onglet Aperçu d'un sous-segment personnalisé. L'aperçu contient l'identifiant du sous-segment, l'identifiant du parent, le nom, les heures de début et de fin, la durée, l'état et les erreurs ou les défauts.
L'onglet Métadonnées d'un sous-segment personnalisé contient des informations au JSON format concernant les ressources utilisées par ce sous-segment.
