Utilisez un AWS Management Console

Consultez la carte de suivi X-Ray pour identifier les services présentant des erreurs, les connexions présentant une latence élevée ou les traces de demandes infructueuses.

Affichage de la carte de suivi

La carte de trace est une représentation visuelle des données de trace générées par vos applications. La carte montre les nœuds de service qui répondent aux demandes, les nœuds clients en amont qui représentent l'origine des demandes et les nœuds de service en aval qui représentent les services Web et les ressources utilisés par une application lors du traitement d'une demande.

La carte de trace affiche une vue connectée des traces dans les applications pilotées par des événements qui utilisent Amazon SQS et Lambda. Pour plus d'informations, consultez la section suivante consacrée aux applications pilotées par des événements Trace. La carte de trace prend également en charge le suivi entre comptes, en affichant les nœuds de plusieurs comptes sur une seule carte.

Filtrer la carte de trace par groupe

À l'aide d'une expression de filtre, vous pouvez définir des critères selon lesquels inclure des traces au sein d'un groupe. Pour plus d'informations sur les expressions de filtre, consultez la section Utiliser des expressions de filtre. Procédez ensuite comme suit pour afficher ce groupe spécifique sur la carte de trace.

La carte des services sera désormais filtrée pour afficher les traces correspondant à l'expression du filtre du groupe sélectionné.

Tracez la légende et les options de la carte

La carte de trace inclut une légende et plusieurs options permettant de personnaliser l'affichage de la carte.

Utilisez la page Traces de la console X-Ray pour rechercher des traces par URL, code de réponse ou autres données dans le 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

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 mis en retrait et listés après le segment. Les colonnes contiennent des informations sur chaque segment.

Lorsque vous utilisez un AWS SDK ou un SQL client instrumenté pour appeler des ressources externes, le SDK X-Ray enregistre automatiquement les sous-segments. HTTP Vous pouvez également utiliser le SDK X-Ray 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 tracé, choisissez le nom d'un segment pour en afficher les détails.

Le panneau Détails du segment affiche les onglets Vue d'ensemble, Ressources, Annotations, Métadonnées, Exceptions et SQL. Les conditions suivantes s'appliquent :

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 :

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 avec AWS X-Ray des SDK. Génération de sous-segments personnalisés avec le SDK X-Ray pour Java

L'image suivante montre l'onglet Vue d'ensemble d'un sous-segment personnalisé. L'aperçu contient l'ID du sous-segment, l'ID parent, le nom, les heures de début et de fin, la durée, le statut et les erreurs ou défauts.

L'onglet Métadonnées d'un sous-segment personnalisé contient des informations au JSON format sur les ressources utilisées par ce sous-segment.

Utilisez des expressions de filtre pour afficher une carte de trace ou les traces d'une demande, d'un service, d'une connexion entre deux services (une périphérie) ou de demandes répondant à une condition spécifique. X-Ray fournit un langage d'expression de filtre pour filtrer les demandes, les services et les limites en fonction des données contenues dans les en-têtes des demandes, de l'état des réponses et des champs indexés des segments d'origine.

Lorsque vous choisissez une période de traces à afficher dans la console X-Ray, vous pouvez obtenir plus de résultats que ce que la console peut afficher. Dans le coin supérieur droit, la console affiche le nombre de suivis qu'elle a analysés et s'il y a d'autres suivis disponibles. Vous pouvez utiliser une expression de filtre pour limiter les résultats aux seules traces que vous souhaitez rechercher.

Lorsque vous choisissez un nœud dans la carte de trace, la console crée une expression de filtre en fonction du nom de service du nœud et des types d'erreurs présents en fonction de votre sélection. Pour trouver les suivis montrant les problèmes de performances ou concernant des demandes spécifiques, vous pouvez ajuster l'expression fournie par la console ou créer vos propres expressions. Si vous ajoutez des annotations avec le SDK X-Ray, vous pouvez également filtrer en fonction de la présence d'une clé d'annotation ou de la valeur d'une clé.

Note

Si vous choisissez une plage de temps relative dans la carte de trace et que vous choisissez un nœud, la console convertit la plage de temps en heure de début et de fin absolues. Pour assurer que les suivis du nœud apparaissent dans les résultats de recherche et éviter d'analyser les heures auxquelles le nœud n'était pas actif, la plage de temps inclut uniquement les heures pendant lesquelles le nœud a envoyé des suivis. Pour effectuer une recherche par rapport à l'heure actuelle, vous pouvez revenir à une plage de temps relative dans la page des suivis et relancer l'analyse.

S'il y a toujours plus de résultats disponibles que la console ne peut en afficher, la console affiche le nombre de suivis correspondants et le nombre de suivis analysés. Le pourcentage affiché est le pourcentage de la période sélectionnée qui a été analysée. Pour vous assurer d’afficher tous les suivis correspondants représentés dans les résultats, réduisez encore votre expression de filtrage ou choisissez une période plus courte.

Pour obtenir les résultats les plus récents en premier, la console démarre l'analyse à la fin de la plage de temps et fonctionne en marche arrière. S'il y a un grand nombre de suivis, mais peu de résultats, la console fractionne la plage de temps en blocs qu'elle analyse en parallèle. La barre de progression indique les parties de la plage de temps qui ont été analysées.

Les groupes constituent un ensemble de suivis qui sont définis par une expression de filtre. Vous pouvez utiliser des groupes pour générer des graphiques de service supplémentaires et fournir CloudWatch des statistiques Amazon.

Les groupes sont identifiés par leur nom ou un Amazon Resource Name (ARN), et contiennent une expression de filtre. Le service compare les suivis entrants à l'expression, et les stocke en conséquence.

Vous pouvez créer et modifier des groupes en utilisant le menu déroulant à gauche de la barre de recherche d'expression de filtre.

Note

Si le service rencontre une erreur en qualifiant un groupe, ce groupe n'est plus inclus dans le traitement des suivis entrants et une métrique d'erreur est enregistrée.

Pour plus d'informations sur les groupes, consultezConfiguration des groupes.

Les expressions de filtrage peuvent contenir un mot-clé, un opérateur unaire ou binaire et une valeur de comparaison.

keyword operator value

Différents opérateurs sont disponibles pour les différents types de mot-clé. Par exemple, responsetime est un mot-clé valeur et peut être comparé aux opérateurs liés à des chiffres.

Exemple — demandes dont le temps de réponse était supérieur à 5 secondes

responsetime > 5

Vous pouvez combiner plusieurs expressions dans une expression composée avec les opérateurs AND ou OR.

Exemple — demandes dont la durée totale était de 5 à 8 secondes

duration >= 5 AND duration <= 8

Les mots-clés et opérateurs simples permettent uniquement de rechercher des problèmes au niveau des données de suivi. Si une erreur survient en aval, mais est gérée par votre application et n'est pas renvoyée à l'utilisateur, la recherche lancée sur error ne la trouvera pas.

Pour trouver des traces présentant des problèmes en aval, vous pouvez utiliser les mots clés complexes service() etedge(). Ces mots-clés vous permettent d'appliquer une expression de filtre à tous les nœuds en aval, à un seul nœud en aval ou à un arc entre deux nœuds. Pour en savoir plus sur ces mots clés, consultez la section Mots clés complexes suivante. Pour encore plus de granularité, vous pouvez filtrer les services et les arcs par type avec la fonction id(). Pour plus d'informations, consultez la section suivante sur la fonction d'identification.

Les valeurs des mots-clés booléens sont true ou false. Utilisez ces mots-clés pour trouver des données de suivi ayant généré des erreurs.

Mots-clés booléens

• ok— Le code d'état de la réponse était 2XX Success.

• error— Le code d'état de la réponse était 4XX Client Error.

• throttle— Le code d'état de la réponse était 429 trop de demandes.

• fault— Le code d'état de la réponse était une erreur de serveur 5XX.

• partial— La demande contient des segments incomplets.

• inferred— La demande contient des segments déduits.

• first— L'élément est le premier d'une liste énumérée.

• last— L'élément est le dernier d'une liste énumérée.

• remote— L'entité responsable est distante.

• root— Le service est le point d'entrée ou le segment racine d'une trace.

Les opérateurs booléens trouvent les segments dans lesquels la clé spécifiée est true ou false.

Opérateurs booléens

• none — L'expression est vraie si le mot clé est vrai.

• !— L'expression est vraie si le mot clé est faux.

• =, != — Comparez la valeur du mot-clé à la chaîne true oufalse. Ces opérateurs agissent de la même manière que les autres opérateurs mais sont plus explicites.

Exemple — le statut de la réponse est 2XX OK

ok

Exemple — le statut de la réponse n'est pas 2XX OK

!ok

Exemple — le statut de la réponse n'est pas 2XX OK

ok = false

Exemple — la dernière trace de panne énumérée porte le nom d'erreur « désérialiser »

rootcause.fault.entity { last and name = "deserialize" }

Exemple — demandes avec des segments distants dont la couverture est supérieure à 0,7 et dont le nom du service est « traces »

rootcause.responsetime.entity { remote and coverage > 0.7 and name = "traces" }

Exemple — requêtes contenant des segments inférés dont le type de service est « AWS:DynamoDB »

rootcause.fault.service { inferred and name = traces and type = "AWS::DynamoDB" }

Exemple — requêtes dont un segment porte le nom « plan de données » comme racine

service("data-plane") {root = true and fault = true}

Utilisez les mots-clés valeur pour rechercher des demandes avec un temps de réponse, une durée ou un statut de réponse spécifique.

Mots-clés valeur

• responsetime— Temps nécessaire au serveur pour envoyer une réponse.

• duration— Durée totale de la demande, y compris tous les appels en aval.

• http.status— Code d'état de la réponse.

• index— Position d'un élément dans une liste énumérée.

• coverage— Pourcentage décimal du temps de réponse de l'entité par rapport au temps de réponse du segment racine. Applicable uniquement aux entités de cause racine des temps de réponse.

Opérateurs numériques

Les mots-clés valeur utilisent l'égalité standard et les opérateurs de comparaison.

• =, != — Le mot clé est égal ou non à une valeur numérique.

• <,<=,>, >= — Le mot clé est inférieur ou supérieur à une valeur numérique.

Exemple — le statut de la réponse n'est pas 200 OK

http.status != 200

Exemple — demande dont la durée totale était de 5 à 8 secondes

duration >= 5 AND duration <= 8

Exemple — demandes traitées avec succès en moins de 3 secondes, y compris tous les appels en aval

ok !partial duration <3

Exemple — entité de liste énumérée dont l'indice est supérieur à 5

rootcause.fault.service { index > 5 }

Exemple — demandes pour lesquelles la dernière entité dont la couverture est supérieure à 0,8

rootcause.responsetime.entity { last and coverage > 0.8 }

Utilisez les mots-clés chaîne pour trouver des données de suivi avec un texte spécifique dans les en-têtes de demande ou des ID utilisateur spécifiques.

Mots-clés chaîne

• http.url— URL de demande.

• http.method— Méthode de demande.

• http.useragent— Demande une chaîne d'agent utilisateur.

• http.clientip— Adresse IP du demandeur.

• user— Valeur du champ utilisateur sur n'importe quel segment de la trace.

• name— Le nom d'un service ou d'une exception.

• type— Type de service

• message— Message d'exception.

• availabilityzone— Valeur du champ de zone de disponibilité sur n'importe quel segment de la trace.

• instance.id— Valeur du champ ID d'instance sur n'importe quel segment de la trace.

• resource.arn— Valeur du champ ARN de la ressource sur n'importe quel segment de la trace.

Les opérateurs chaîne trouvent des valeurs qui sont égales à un texte spécifique ou contiennent un texte spécifique. Ces valeurs doivent toujours être spécifiées entre guillemets.

Opérateurs de chaîne

• =, != — Le mot clé est égal ou non à une valeur numérique.

• CONTAINS— Le mot clé contient une chaîne spécifique.

• BEGINSWITH, ENDSWITH — Le mot clé commence ou se termine par une chaîne spécifique.

Exemple — filtre http.url

http.url CONTAINS "/api/game/"

Pour vérifier si un champ existe sur une donnée de suivi, quelle que soit sa valeur, vérifiez si elle contient la chaîne vide.

Exemple — filtre utilisateur

Recherchez toutes les données de suivi avec des ID utilisateur.

user CONTAINS ""

Exemple — sélectionnez les traces dont la cause première du défaut inclut un service appelé « Auth »

rootcause.fault.service { name = "Auth" }

Exemple — sélectionne les traces dont la cause première est le temps de réponse et dont le dernier service est de type DynamoDB

rootcause.responsetime.service { last and type = "AWS::DynamoDB" }

Exemple — sélectionne les traces dont la cause première est une erreur dont la dernière exception contient le message « accès refusé pour account_id : 1234567890 »

rootcause.fault.exception { last and message = "Access Denied for account_id: 1234567890" 

Utilisez les mots-clés complexes pour trouver des demandes en fonction du nom du service, du nom de l'arc ou d'une valeur d'annotation. Pour les services et les arcs, vous pouvez spécifier une expression de filtrage supplémentaire qui s'applique au service ou à l'arc. Pour les annotations, vous pouvez appliquer un filtre sur la valeur d'une annotation avec une clé spécifique en utilisant des opérateurs booléens, numériques ou de chaîne.

Mots-clés complexes

• annotation.key— Valeur d'une annotation avec clé de champ. La valeur d'une annotation peut être un opérateur booléen, une valeur numérique ou une chaîne. Vous pouvez donc utiliser n'importe lequel de ces types d'opérateurs de comparaison. Vous pouvez utiliser ce mot clé en combinaison avec le edge mot clé service or.

• edge(source, destination) {filter}— Connexion entre la source et la destination des services. Vous pouvez, si vous le souhaitez, utiliser des accolades pour englober une expression de filtrage à appliquer aux segments de cette connexion.

• group.name / group.arn— La valeur de l'expression de filtre d'un groupe, référencée par le nom ou l'ARN du groupe.

• json— Objet de la cause première au format JSON. Consultez Getting data from AWS X-Ray pour connaître les étapes de création d'entités JSON par programmation.

• service(name) {filter}— Service avec nom et prénom. Vous pouvez, si vous le souhaitez, utiliser des accolades pour englober une expression de filtrage à appliquer aux segments créés par le service.

Utilisez le mot clé service pour trouver des traces pour les requêtes qui atteignent un certain nœud de votre carte de suivi.

Les opérateurs de mots clés complexes trouvent les segments dans lesquels la clé spécifiée a été définie ou non définie.

Opérateurs de mots clés complexes

• none — L'expression est vraie si le mot clé est défini. Si le mot clé est de type booléen, il sera évalué à la valeur booléenne.

• !— L'expression est vraie si le mot clé n'est pas défini. Si le mot clé est de type booléen, il sera évalué à la valeur booléenne.

• =, != — Comparez la valeur du mot clé.

• edge(source, destination) {filter}— Connexion entre la source et la destination des services. Vous pouvez, si vous le souhaitez, utiliser des accolades pour englober une expression de filtrage à appliquer aux segments de cette connexion.

• annotation.key— Valeur d'une annotation avec clé de champ. La valeur d'une annotation peut être un opérateur booléen, une valeur numérique ou une chaîne. Vous pouvez donc utiliser n'importe lequel de ces types d'opérateurs de comparaison. Vous pouvez utiliser ce mot clé en combinaison avec le edge mot clé service or.

• json— Objet de la cause première au format JSON. Consultez Getting data from AWS X-Ray pour connaître les étapes de création d'entités JSON par programmation.

Utilisez le mot clé service pour trouver des traces pour les requêtes qui atteignent un certain nœud de votre carte de suivi.

Exemple — Filtre de service

Demandes comprenant un appel vers api.example.com avec une anomalie (erreur de la série 500).

service("api.example.com") { fault }

Vous pouvez exclure le nom du service pour appliquer une expression de filtre à tous les nœuds sur votre cartographie des services.

Exemple — filtre de service

Demandes à l'origine d'une erreur n'importe où sur votre carte de trace.

service() { fault }

Le mot-clé arc applique une expression de filtre à une connexion entre deux nœuds.

Exemple — filtre de bord

Demande pour laquelle l'appel du service api.example.com à backend.example.com a échoué suite à une erreur.

edge("api.example.com", "backend.example.com") { error }

Vous pouvez également utiliser l'opérateur ! avec les mots-clés service et arc pour exclure un service ou un arc des résultats d'une autre expression de filtre.

Exemple — filtre de service et de demande

Demande pour laquelle l'URL commence par http://api.example.com/ et inclut /v2/ mais ne contacte pas un service nommé api.example.com.

http.url BEGINSWITH "http://api.example.com/" AND http.url CONTAINS "/v2/" AND !service("api.example.com")

Exemple — filtre de service et de temps de réponse

Trouvez des traces là où http url est défini et où le temps de réponse est supérieur à 2 secondes.

http.url AND responseTime > 2

Pour les annotations, vous pouvez appeler toutes les traces où annotation.key est défini ou utiliser les opérateurs de comparaison correspondant au type de valeur.

Exemple — annotation avec valeur de chaîne

Demandes avec une annotation nommée gameid avec une valeur de chaîne "817DL6VO".

annotation.gameid = "817DL6VO"

Exemple — l'annotation est définie

Demandes avec une annotation nommée age set.

annotation.age

Exemple — l'annotation n'est pas définie

Demandes sans annotation nommées age set.

!annotation.age

Exemple — annotation avec valeur numérique

Demandes avec un âge d'annotation avec une valeur numérique supérieure à 29.

annotation.age > 29

Exemple — annotation en combinaison avec le service ou l'arête

service { annotation.request_id = "917DL6VO" }

edge { source.annotation.request_id = "916DL6VO" }

edge { destination.annotation.request_id = "918DL6VO" }

Exemple — groupe avec utilisateur

Demandes où les traces rencontrent le filtre de high_response_time groupe (par exempleresponseTime > 3) et où l'utilisateur s'appelle Alice.

group.name = "high_response_time" AND user = "alice"

Exemple — JSON avec entité de cause première

Requêtes avec entités de cause racine correspondantes.

rootcause.json = #[{ "Services": [ { "Name": "GetWeatherData", "EntityPath": [{ "Name": "GetWeatherData" }, { "Name": "get_temperature" } ] }, { "Name": "GetTemperature", "EntityPath": [ { "Name": "GetTemperature" } ] } ] }]

Lorsque vous fournissez un nom de service pour les mots-clés service ou edge, vous obtenez des résultats pour tous les nœuds correspondant à ce nom. Pour un filtrage plus précis, vous pouvez utiliser la fonction id pour spécifier un type de service en plus d'un nom et faire la distinction entre les nœuds portant le même nom.

Utilisez cette account.id fonction pour spécifier un compte particulier pour le service, lorsque vous consultez les traces de plusieurs comptes dans un compte de surveillance.

id(name: "service-name", type:"service::type", account.id:"account-ID")

Vous pouvez utiliser la fonction id à la place d'un nom de service dans les filtres de service et d'arc.

service(id(name: "service-name", type:"service::type")) { filter }

edge(id(name: "service-one", type:"service::type"), id(name: "service-two", type:"service::type")) { filter }

Par exemple, AWS Lambda les fonctions génèrent deux nœuds dans la carte de trace : un pour l'invocation de la fonction et un pour le service Lambda. Les deux nœuds ont le même nom, mais des types différents. Un filtre de service standard trouvera des données de suivi pour les deux.

Exemple — filtre de service

Demandes qui incluent une erreur sur n'importe quel service nommé random-name.

service("function-name") { error }

Utilisez la fonction id pour limiter la recherche aux erreurs portant sur la fonction elle-même et exclure les erreurs du service.

Exemple — filtre de service avec fonction id

Demandes qui incluent une erreur sur un service nommé random-name de type AWS::Lambda::Function.

service(id(name: "random-name", type: "AWS::Lambda::Function")) { error }

Pour rechercher des nœuds par type, vous pouvez également exclure complètement le nom.

Exemple — filtre de service avec fonction d'identification et type de service

Demandes qui incluent une erreur sur un service de type AWS::Lambda::Function.

service(id(type: "AWS::Lambda::Function")) { error }

Pour rechercher des nœuds pour un utilisateur en particulier Compte AWS, spécifiez un ID de compte.

Exemple — filtre de service avec fonction d'identification et identifiant de compte

Demandes qui incluent un service associé à un identifiant de compte spécifiqueAWS::Lambda::Function.

service(id(account.id: "account-id"))

AWS X-Ray prend en charge l'observabilité entre comptes, vous permettant de surveiller et de dépanner les applications qui couvrent plusieurs comptes au sein d'un. Région AWS Vous pouvez facilement rechercher, visualiser et analyser vos indicateurs, journaux et traces dans tous les comptes associés, comme si vous travailliez sur un seul compte. Cela fournit une vue complète des demandes qui transitent par plusieurs comptes. Vous pouvez consulter les traces entre comptes sur la carte de suivi X-Ray et sur les pages de traces de la CloudWatchconsole.

Les données d'observabilité partagées peuvent inclure l'un des types de télémétrie suivants :

Configurer l'observabilité entre comptes

Pour activer l'observabilité entre comptes, configurez un ou plusieurs comptes de AWS surveillance et associez-les à plusieurs comptes sources. Un compte de surveillance est une centrale Compte AWS qui permet de visualiser et d'interagir avec les données d'observabilité générées à partir des comptes sources. Un compte source est une personne Compte AWS qui génère des données d'observabilité pour les ressources qu'il contient.

Les comptes sources partagent leurs données d'observabilité avec les comptes de surveillance. Les traces sont copiées de chaque compte source vers un maximum de cinq comptes de surveillance. Les copies des traces des comptes sources vers le premier compte de surveillance sont gratuites. Les copies des traces envoyées à des comptes de surveillance supplémentaires sont facturées à chaque compte source, sur la base de la tarification standard. Pour plus d'informations, consultez les sections AWS X-Ray Tarification et CloudWatch Tarification Amazon.

Pour créer des liens entre les comptes de surveillance et les comptes sources, utilisez la CloudWatch console ou les nouvelles commandes Observability Access Manager de l'API AWS CLI and. Pour plus d'informations, consultez la CloudWatch section Observabilité entre comptes.

Afficher les traces entre comptes

Les traces entre comptes sont affichées dans le compte de surveillance. Chaque compte source affiche uniquement les traces locales pour ce compte spécifique. Les sections suivantes supposent que vous êtes connecté au compte de surveillance et que vous avez ouvert la CloudWatch console Amazon. Sur les pages de la carte de suivi et des traces, un badge de compte de surveillance est affiché dans le coin supérieur droit.

Carte de traçage

Dans la CloudWatch console, choisissez Trace Map sous X-Ray Traces dans le volet de navigation de gauche. Par défaut, la carte de suivi affiche les nœuds de tous les comptes sources qui envoient des traces au compte de surveillance, ainsi que les nœuds du compte de surveillance lui-même. Sur la carte de trace, choisissez Filtres en haut à gauche pour filtrer la carte de trace à l'aide de la liste déroulante Comptes. Une fois qu'un filtre de compte est appliqué, les nœuds de service des comptes qui ne correspondent pas au filtre actuel sont grisés.

Lorsque vous choisissez un nœud de service, le volet de détails du nœud inclut l'ID de compte et le libellé du service.

Dans le coin supérieur droit de la carte de trace, choisissez Affichage en liste pour afficher la liste des nœuds de service. La liste des nœuds de service inclut les services du compte de surveillance et tous les comptes sources configurés. Filtrez la liste des nœuds par étiquette de compte ou identifiant de compte en les choisissant dans le filtre Nœuds.

Suivis

Consultez les détails des traces couvrant plusieurs comptes en ouvrant la CloudWatch console depuis le compte de surveillance et en choisissant Traces sous X-Ray Traces dans le volet de navigation de gauche. Vous pouvez également ouvrir cette page en choisissant un nœud dans la X-Ray Trace Map, puis en choisissant View traces dans le volet des détails du nœud.

La page Traces permet d'effectuer des requêtes par identifiant de compte. Pour commencer, saisissez une requête qui inclut un ou plusieurs ID de compte. Pour plus d'informations sur les requêtes, consultezUtiliser des expressions de filtre. L'exemple suivant demande des traces transmises par l'ID de compte X ou Y :

service(id(account.id:"X")) OR service(id(account.id:"Y"))

Affinez votre requête par compte. Sélectionnez un ou plusieurs comptes dans la liste, puis cliquez sur Ajouter à la requête.

Détails du tracé

Consultez les détails d'une trace en la sélectionnant dans la liste Traces en bas de la page Traces. Les détails du suivi s'affichent, y compris une carte des détails du suivi avec les nœuds de service de tous les comptes traversés par le suivi. Choisissez un nœud de service spécifique pour voir le compte correspondant.

La section Chronologie des segments affiche les détails du compte pour chaque segment de la chronologie.

AWS X-Ray prend en charge le suivi des applications pilotées par des événements à l'aide d'Amazon SQS et. AWS Lambda Utilisez la CloudWatch console pour voir une vue connectée de chaque demande mise en file d'attente avec Amazon SQS et traitée par une ou plusieurs fonctions Lambda. Les traces provenant des producteurs de messages en amont sont automatiquement liées aux traces provenant des nœuds consommateurs Lambda en aval, créant ainsi une end-to-end vue de l'application.

Afficher les traces liées dans la carte des traces

Utilisez la page Trace Map de la CloudWatchconsole pour afficher une carte de suivi contenant les traces des producteurs de messages associées aux traces des consommateurs Lambda. Ces liens sont affichés avec un bord en pointillé qui connecte le nœud Amazon SQS aux nœuds consommateurs Lambda en aval.

Sélectionnez un bord en pointillé pour afficher un histogramme de l'âge de l'événement reçu, qui indique la répartition de l'âge de l'événement lorsqu'il est reçu par les consommateurs. L'âge est calculé chaque fois qu'un événement est reçu.

Afficher les détails du suivi lié

La carte des détails de la trace affiche la trace actuelle, ainsi que les traces liées en amont et en aval, chacune d'elles étant contenue dans un cadre indiquant les limites de chaque trace. Si la trace actuellement sélectionnée est liée à plusieurs traces en amont ou en aval, les nœuds des traces liées en amont ou en aval sont empilés et un bouton Sélectionner une trace s'affiche.

Sous la carte des détails du tracé, une chronologie des segments de trace s'affiche, y compris les traces liées en amont et en aval. S'il existe plusieurs traces liées en amont ou en aval, les détails de leurs segments ne peuvent pas être affichés. Pour afficher les détails d'un segment pour une seule trace au sein d'un ensemble de traces liées, sélectionnez une seule trace comme décrit dans la section suivante.

Sélectionnez une seule trace parmi un ensemble de traces liées

Lorsque vous sélectionnez un nœud ou une arête sur une carte de traçage, la console X-Ray affiche un histogramme de distribution de latence.

Latence

La latence correspond au temps écoulé entre le moment où une demande commence et celui où elle prend fin. Un histogramme montre la répartition des latences. Il indique la durée sur l'axe X et le pourcentage de demandes correspondant à chaque durée sur l'axe Y.

Cet histogramme montre un service qui répond à la plupart des demandes en moins de 300 ms. Un faible pourcentage des demandes prennent jusqu'à 2 secondes et quelques valeurs hors norme peuvent prendre un peu plus de temps.

Interprétation des détails du service

Les histogrammes des services et des arcs offrent une représentation visuelle des latences du point de vue d'un service ou d'un demandeur.

Pour interpréter l'histogramme du panneau Service details, vous pouvez rechercher les valeurs les plus extrêmes. Ces valeurs hors norme peuvent être considérées comme des pics dans l'histogramme. Vous pouvez alors consulter les suivis d'une zone donnée pour voir ce qu'il se passe.

Pour afficher les suivis filtrés par latence, sélectionnez une plage dans l'histogramme. Cliquez à l'endroit où vous souhaitez commencer la sélection et faites glisser la souris de la gauche vers la droite pour mettre en surbrillance une plage de latences à inclure dans le filtre de suivi.

Une fois que vous avez sélectionné une plage, vous pouvez choisir Zoom pour afficher uniquement une certaine partie de l'histogramme et affiner votre sélection.

Une fois que vous avez défini la zone qui vous intéresse, choisissez View traces.

AWS X-Ray analyse en permanence les données de suivi de votre compte afin d'identifier les problèmes émergents dans vos applications. Lorsque les taux de défaillance dépassent la plage prévue, cela crée un aperçu qui enregistre le problème et suit son impact jusqu'à ce qu'il soit résolu. Avec Insights, vous pouvez :

La console X-Ray identifie les nœuds présentant des incidents en cours sur la carte de trace. Pour voir un résumé des informations, choisissez le nœud concerné. Vous pouvez également afficher et filtrer les informations en choisissant Insights dans le volet de navigation de gauche.

X-Ray crée un aperçu lorsqu'il détecte une anomalie dans un ou plusieurs nœuds de la carte des services. Le service utilise une modélisation statistique pour prévoir les taux de défaillance attendus des services de votre application. Dans l'exemple précédent, l'anomalie est une augmentation du nombre de défauts provenant de AWS Elastic Beanstalk. Le serveur Elastic Beanstalk a connu plusieurs délais d'attente pour les appels d'API, ce qui a provoqué une anomalie dans les nœuds en aval.

Activer Insights dans la console X-Ray

Insights doit être activé pour chaque groupe avec lequel vous souhaitez utiliser les fonctionnalités Insights. Vous pouvez activer les informations depuis la page Groupes.

          {
             "Version": "2012-10-17",
             "Statement": [
                 {
                     "Effect": "Allow",
                     "Action": [
                         "xray:GetInsightSummaries",
                         "xray:GetInsight",
                         "xray:GetInsightEvents",
                         "xray:GetInsightImpactGraph"
                     ],
                     "Resource": [
                         "*"
                     ]
                 }
             ]
         }
      

Activez les notifications d'informations

Avec les notifications d'informations, une notification est créée pour chaque événement d'information, par exemple lorsqu'une information est créée, change de manière significative ou est fermée. Les clients peuvent recevoir ces notifications par le biais d' EventBridge événements Amazon et utiliser des règles conditionnelles pour effectuer des actions telles que la notification SNS, l'invocation Lambda, la publication de messages dans une file d'attente SQS ou l'un des supports cibles. EventBridge Les notifications Insights sont émises dans la mesure du possible, mais ne sont pas garanties. Pour plus d'informations sur les cibles, consultez Amazon EventBridge Targets.

Vous pouvez activer les notifications d'informations pour tout groupe activé sur la page Groupes.

Aperçu d'Insight

La page de présentation d'un aperçu tente de répondre à trois questions clés :

La section Services anormaux présente une chronologie pour chaque service qui illustre l'évolution du taux de défaillance au cours de l'incident. La chronologie indique le nombre de traces comportant des défaillances superposées sur une bande continue qui indique le nombre de défaillances attendu en fonction du volume de trafic enregistré. La durée de l'aperçu est visualisée par la fenêtre Incident. La fenêtre d'incident commence lorsque X-Ray observe que la métrique devient anormale et persiste tant que l'aperçu est actif.

L'exemple suivant montre une augmentation du nombre de défaillances à l'origine d'un incident :

La section Cause première affiche une carte de trace axée sur le service responsable et le chemin concerné. Vous pouvez masquer les nœuds non affectés en sélectionnant l'icône en forme d'œil en haut à droite de la carte des causes profondes. Le service responsable est le nœud le plus en aval où X-Ray a identifié une anomalie. Il peut s'agir d'un service que vous avez instrumenté ou d'un service externe que votre service a appelé auprès d'un client instrumenté. Par exemple, si vous appelez Amazon DynamoDB avec un client SDK AWS instrumenté, l'augmentation du nombre de défaillances provenant de DynamoDB permet d'obtenir un aperçu dont DynamoDB est la cause première.

Pour étudier plus en détail la cause première, sélectionnez Afficher les détails de la cause première sur le graphique des causes premières. Vous pouvez utiliser la page Analytics pour rechercher la cause première et les messages associés. Pour plus d’informations, consultez Interagissez avec la console Analytics.

Les défaillances qui se poursuivent en amont de la carte peuvent avoir un impact sur plusieurs nœuds et provoquer de multiples anomalies. Si une erreur est retransmise à l'utilisateur qui a fait la demande, il en résulte une erreur du client. Il s'agit d'un défaut dans le nœud racine de la carte de trace. Le graphique d'impact fournit une chronologie de l'expérience client pour l'ensemble du groupe. Cette expérience est calculée en fonction des pourcentages des états suivants : Fault, Error, Throttle et OK.

Cet exemple montre une augmentation du nombre de traces associées à une défaillance au niveau du nœud racine au moment d'un incident. Les incidents dans les services en aval ne correspondent pas toujours à une augmentation des erreurs des clients.

Choisissez Analyze insight pour ouvrir la console X-Ray Analytics dans une fenêtre dans laquelle vous pouvez examiner en détail l'ensemble des traces à l'origine de l'aperçu. Pour plus d’informations, consultez Interagissez avec la console Analytics.

Comprendre l'impact

AWS X-Ray mesure l'impact causé par un problème récurrent dans le cadre de la génération d'informations et de notifications. L'impact est mesuré de deux manières :

Cet impact est déterminé par le pourcentage de demandes qui échouent ou sont à l'origine d'une erreur au cours d'une période donnée. Cette analyse d'impact vous permet de déterminer la gravité et la priorité du problème en fonction de votre scénario particulier. Cet impact est disponible dans le cadre de l'expérience console, en plus des notifications d'informations.

Déduplication

AWS X-Ray Insights déduplique les problèmes sur plusieurs microservices. Il utilise la détection des anomalies pour déterminer le service à l'origine d'un problème, déterminer si d'autres services connexes présentent un comportement anormal dû à la même cause première et enregistre le résultat sous forme d'aperçu unique.

Passez en revue la progression d'un aperçu

X-Ray réévalue régulièrement les informations jusqu'à ce qu'elles soient résolues, et enregistre chaque modification intermédiaire notable sous forme de notification, qui peut être envoyée sous forme d'événement Amazon EventBridge . Cela vous permet de créer des processus et des flux de travail pour déterminer l'évolution du problème au fil du temps et de prendre les mesures appropriées, telles que l'envoi d'un e-mail ou l'intégration à un système d'alerte utilisant EventBridge.

Vous pouvez consulter les événements de l'incident dans la chronologie de l'impact sur la page Inspect. Par défaut, la chronologie affiche le service le plus touché jusqu'à ce que vous choisissiez un autre service.

Pour consulter une carte de suivi et des graphiques d'un événement, sélectionnez-le dans la chronologie de l'impact. La carte de suivi indique les services de votre application concernés par l'incident. Sous Analyse d'impact, les graphiques indiquent la chronologie des défaillances pour le nœud sélectionné et pour les clients du groupe.

Pour examiner de manière plus approfondie les traces impliquées dans un incident, choisissez Analyser l'événement sur la page Inspecter. Vous pouvez utiliser la page Analytics pour affiner la liste des traces et identifier les utilisateurs concernés. Pour plus d’informations, consultez Interagissez avec la console Analytics.

La console AWS X-Ray Analytics est un outil interactif permettant d'interpréter les données de trace afin de comprendre rapidement les performances de votre application et de ses services sous-jacents. La console vous permet d'explorer, d'analyser et de visualiser les suivis grâce à des graphiques interactifs sur les temps de réponse et la chronologie.

Lorsque vous sélectionnez un élément dans la console Analytics, celle-ci crée des filtres afin d’afficher le sous-ensemble de suivis sélectionné. Vous pouvez affiner l’ensemble de données actif en appliquant des filtres de plus en plus précis. Pour ce faire, cliquez sur les graphiques, les panneaux de métriques et les champs associés à l’ensemble de suivis sélectionné.

La console X-Ray Analytics utilise les fonctionnalités clés suivantes pour regrouper, filtrer, comparer et quantifier les données de suivi.

Fonctionnalités

Fonctionnalité	Description
Groups (Groupes)	Le premier groupe sélectionné est Default. Pour modifier le groupe extrait, sélectionnez un groupe différent dans le menu situé à droite de la barre de recherche principale pour les expressions de filtre. Pour en savoir plus sur les groupes, voir Configurer les groupes.
Retrieved traces (Suivis extraits)	Par défaut, la console Analytics génère des graphiques basés sur tous les suivis du groupe sélectionné. Les suivis extraits représentent tous les suivis de l’ensemble sur lequel vous travaillez. Le nombre de suivis est affiché dans cette vignette. Les expressions de filtre que vous appliquez à la barre de recherche principale affinent et mettent à jour les suivis extraits.
Show in charts/Hide from charts (Afficher dans les graphiques/Masquer dans les graphiques)	Une fonctionnalité de basculement pour comparer le groupe actif aux suivis extraits. Pour comparer les données du groupe aux filtres actifs, sélectionnez Show in charts (Afficher dans les graphiques). Pour supprimer cette vue des graphiques, sélectionnez Hide from charts (Masquer dans les graphiques).
Filtered trace set A (Ensemble de suivis filtrés A)	En interagissant avec les graphiques et les tableaux, appliquez des filtres pour créer les critères du jeu de traces filtré A. Au fur et à mesure que les filtres sont appliqués, le nombre de traces applicables et le pourcentage de traces extraites par rapport au total sont calculés dans cette vignette. Les filtres sont renseignés comme des balises au sein de la vignette Filtered trace set A (Ensemble de suivis filtrés A) et peuvent également être supprimés de la vignette.
Refine (Affiner)	Cette fonction met à jour l'ensemble des suivis extraits en fonction des filtres appliqués à l'ensemble de suivis A. L'affinage de l'ensemble permet d'actualiser le jeu de suivis extraits sur lequel vous travaillez en fonction des filtres de l'ensemble des suivis A. L'ensemble des suivis extraits sur lequel vous travaillez est un exemple de sous-ensemble de tous les suivis du groupe.
Filtered trace set B (Ensemble de suivis filtrés B)	Une fois créé, le jeu de traces filtré B est une copie du jeu de traces filtré A. Pour comparer les deux ensembles de traces, effectuez de nouvelles sélections de filtres qui s'appliqueront au jeu de traces B, tandis que le jeu de traces A reste fixe. À mesure que les filtres sont appliqués, le nombre de suivis applicables ainsi que le pourcentage de suivis par rapport au nombre total de suivis extraits sont recalculés au sein de la vignette. Les filtres sont renseignés comme des balises au sein de la vignette Filtered trace set B (Ensemble de suivis filtrés B). Ils peuvent également être supprimés de la vignette.
Response Time Root Cause Entity Paths (Chemins d’entité constituant la cause racine du temps de réponse)	Tableau des chemins d'entités enregistrés. X-Ray détermine la trajectoire de votre trace qui est la cause la plus probable du temps de réponse. Le format indique une hiérarchie d’entités qui a été rencontrée, qui constitue la cause racine du temps de réponse. Utilisez ces lignes pour filtrer les erreurs de temps de réponse récurrentes. Pour plus d'informations sur la personnalisation d'un filtre de cause première et sur l'obtention de données via l'API, consultez la section Extraction et affinement des analyses des causes profondes dans. Obtenir des données depuis X-Ray
Delta (�)	Colonne qui est ajoutée aux tables de métriques lorsque les ensembles A et B sont tous les deux actifs. La colonne Delta calcule la différence de suivis entre l'ensemble A et l'ensemble B sous forme de pourcentage.

La console X-Ray Analytics génère deux graphiques principaux pour vous aider à visualiser les traces : la distribution du temps de réponse et l'activité des séries chronologiques. Cette section fournit des exemples de chacun de ces graphiques, et explique les principes de base pour savoir les lire.

Voici les couleurs associées au graphique linéaire des temps de réponse (le graphique chronologique utilise le même code couleurs) :

• Toutes les traces du groupe — gris

• Traces récupérées — orange

• Set de traces filtrées A — vert

• Set de traces filtrées B — bleu

Exemple — Répartition du temps de réponse

La distribution des temps de réponse est un graphique qui montre le nombre de suivis correspondant à un temps de réponse donné. Cliquez et faites glisser pour effectuer des sélections au sein du graphique de distribution des temps de réponse. Lorsque vous effectuez une sélection, un filtre est créé pour l’ensemble des suivis actifs. Cet ensemble est appelé responseTime, et correspond à tous les suivis au sein d'un temps de réponse spécifique.

Le graphique sur les activités chronologiques affiche le nombre de suivis sur une période donnée. Les indicateurs de couleurs reflètent le graphique linéaire de distribution des temps de réponse. Plus le bloc de couleur est foncé et rempli dans les activités chronologiques, plus la quantité de suivis représentée est élevée pour la période de temps donnée.

Exemple — Activité liée aux séries chronologiques

Cliquez et faites glisser pour effectuer des sélections au sein du graphique d’activités chronologiques. Lorsque vous effectuez une sélection, un filtre appelé timerange est créé pour l’ensemble des suivis actifs au sein d’une période de temps spécifique.

Les exemples suivants présentent des cas d'utilisation courants de la console X-Ray Analytics. Chaque exemple montre une fonctionnalité clé de la console. En tant que groupe, les exemples suivent un flux de travail basique pour la résolution de problèmes. Les étapes expliquent comment repérer d'abord les nœuds défectueux, puis comment interagir avec la console Analytics pour générer automatiquement des requêtes comparatives. Une fois que vous avez réduit la portée par le biais de requêtes, vous examinez enfin les détails des suivis d'intérêt pour déterminer ce qui nuit à l'état de votre service.

La carte de suivi indique l'état de santé de chaque nœud en le colorant en fonction du rapport entre les appels réussis et les erreurs et les défaillances. Lorsque votre nœud affiche un pourcentage rouge, cela indique une erreur. Utilisez la console X-Ray Analytics pour l'étudier.

Pour plus d'informations sur la façon de lire la carte de trace, voir Utiliser la carte de trace X-Ray.

À l’aide du graphique sur la distribution des temps de réponse, vous pouvez observer les pics. Lorsque vous sélectionnez un pic dans les temps de réponse, les tables en dessous des graphiques se mettent à jour afin d'afficher toutes les métriques associées, comme les codes d'état.

Lorsque vous cliquez et faites glisser le pointeur, X-Ray sélectionne et crée un filtre. Il est grisé au-dessus des lignes du graphique. Vous pouvez alors faire glisser cet élément grisé vers la gauche ou vers la droite de la distribution pour modifier la sélection et filtrer.

Vous pouvez afficher le détail des suivis au sein du pic sélectionné à l’aide des tables de métriques en dessous des graphiques. En cliquant sur une ligne de la table HTTP STATUS CODE (CODE D’ÉTAT HTTP), vous créez automatiquement un filtre pour l’ensemble de données actif. Par exemple, vous pouvez afficher tous les suivis du code d'état 500. Une balise de filtre est alors créée dans la vignette de l’ensemble des suivis nommé http.status.

Affichez le détail de l’ensemble des erreurs en fonction de l’utilisateur, de l’URL, de la cause racine du temps de réponse et d’autres attributs prédéfinis. Par exemple, pour filtrer l'ensemble des suivis dont le code d’état est 500, sélectionnez une ligne dans la table USERS (UTILISATEURS). Deux balises de filtre sont alors générées dans la vignette de l’ensemble des suivis : http.status, comme indiqué précédemment, et user.

Comparez plusieurs utilisateurs et leurs requêtes POST pour identifier des divergences et des corrélations. Appliquez votre premier ensemble de filtres. Ils sont indiqués par une ligne bleue dans le graphique de distribution des temps de réponse. Ensuite, sélectionnez Compare (Comparer). Pour commencer, une copie des filtres est créée sur l’ensemble des suivis A.

Ensuite, définissez un nouvel ensemble de filtres à appliquer à l’ensemble des suivis B. Ce deuxième ensemble est représenté par une ligne verte. L'exemple suivant montre les différentes courbes conformément au code de couleurs (bleu et vert).

À mesure que vous réduisez le champ d’application à l’aide des filtres de la console, la liste des suivis en dessous des tables de métriques devient plus parlante. La table de la liste des suivis combine des informations sur l'URL, l'UTILISATEUR, et le CODE D'ÉTAT dans une même vue. Pour obtenir plus d’informations, sélectionnez une ligne de la table afin d’ouvrir la page détaillée du suivi et d’examiner sa chronologie et ses données brutes.

Les groupes constituent un ensemble de suivis qui sont définis par une expression de filtre. Vous pouvez utiliser des groupes pour générer des graphiques de service supplémentaires et fournir CloudWatch des statistiques Amazon. Vous pouvez utiliser la AWS X-Ray console ou l'API X-Ray pour créer et gérer des groupes pour vos services. Cette rubrique explique comment créer et gérer des groupes à l'aide de la console X-Ray. Pour plus d'informations sur la gestion des groupes à l'aide de l'API X-Ray, consultezConfiguration des paramètres d'échantillonnage, de groupes et de chiffrement avec l'API X-Ray.

Vous pouvez créer des groupes de traces pour les cartes de traçage, les traces ou les analyses. Lorsque vous créez un groupe, celui-ci devient disponible sous forme de filtre dans le menu déroulant du groupe sur les trois pages : Trace Map, Traces et Analytics.

Les groupes sont identifiés par leur nom ou un Amazon Resource Name (ARN), et contiennent une expression de filtre. Le service compare les suivis entrants à l'expression, et les stocke en conséquence. Pour plus d'informations sur la création d'une expression de filtre, consultezUtiliser des expressions de filtre.

Le fait de mettre à jour l'expression de filtrage d'un groupe n'a pas pour effet de modifier les données déjà enregistrées. La mise à jour s'applique uniquement aux suivis ultérieurs. Cela peut entraîner la fusion des expressions nouvelles et anciennes dans le graphique. Pour éviter cela, supprimez le groupe actuel et créez-en un nouveau.

Créez un groupe

Appliquer un groupe

Modifier un groupe

Cloner un groupe

Le clonage d'un groupe crée un nouveau groupe qui possède l'expression de filtre et les balises d'un groupe existant. Lorsque vous clonez un groupe, le nouveau groupe porte le même nom que le groupe à partir duquel il a été cloné, avec un -clone ajout au nom.

Supprimer un groupe

Suivez les étapes décrites dans cette section pour supprimer un groupe. Vous ne pouvez pas supprimer le groupe par défaut.

Afficher les statistiques du groupe sur Amazon CloudWatch

Après la création d'un groupe, les traces entrantes sont vérifiées par rapport à l'expression du filtre du groupe lorsqu'elles sont stockées dans le service X-Ray. Les statistiques relatives au nombre de traces correspondant à chaque critère sont publiées sur Amazon CloudWatch toutes les minutes. Choisir Afficher la métrique sur la page Modifier le groupe ouvre la CloudWatch console sur la page Métrique. Pour plus d'informations sur l'utilisation des CloudWatch métriques, consultez la section Utilisation d'Amazon CloudWatch Metrics dans le guide de CloudWatch l'utilisateur Amazon.

Vous pouvez utiliser la AWS X-Ray console pour configurer les règles d'échantillonnage pour vos services. Le SDK X-Ray et ceux Services AWS qui prennent en charge le traçage actif avec configuration d'échantillonnage utilisent des règles d'échantillonnage pour déterminer les demandes à enregistrer.

Configuration des règles d'échantillonnage

Vous pouvez configurer l'échantillonnage pour les cas d'utilisation suivants :

Personnalisation des règles d'échantillonnage

En personnalisant les règles d'échantillonnage, vous pouvez contrôler la quantité de données que vous enregistrez. Vous pouvez également modifier le comportement d'échantillonnage sans modifier ni redéployer votre code. Les règles d'échantillonnage indiquent au SDK X-Ray le nombre de demandes à enregistrer pour un ensemble de critères. Par défaut, le SDK X-Ray enregistre la première demande reçue au début de chaque seconde, et 5 % des demandes supplémentaires. Une demande par seconde est le réservoir. Ceci garantit qu'au moins une trace est enregistrée chaque seconde aussi longtemps que le service traite les demandes. 5 % est la fréquence à laquelle les demandes supplémentaires au-delà du réservoir sont échantillonnées.

Vous pouvez configurer le SDK X-Ray pour lire les règles d'échantillonnage à partir d'un document JSON que vous incluez dans votre code. Cependant, lorsque vous exécutez plusieurs instances de votre service, chaque instance exécute l'échantillonnage de manière indépendante. Ceci entraîne une augmentation du pourcentage global des demandes échantillonnées, car les réservoirs de toute les instances sont effectivement additionnés. En outre, pour mettre à jour les règles d'échantillonnage locales, vous devez redéployer votre code.

En définissant des règles d'échantillonnage dans la console X-Ray et en configurant le SDK pour lire les règles du service X-Ray, vous pouvez éviter ces deux problèmes. Le service gère le réservoir pour chaque règle et attribue les quotas à chaque instance de votre service pour distribuer le réservoir de façon uniforme, en fonction du nombre d'instances qui sont en cours d'exécution. La limite de réservoir est calculée selon les règles que vous avez définies. Les règles étant configurées dans le service, vous pouvez les gérer sans effectuer de déploiements supplémentaires. Pour plus d'informations sur le AWS SDK, consultez la section Utiliser un SDK.

Vous pouvez désormais configurer les règles d'échantillonnage X-Ray depuis la CloudWatch console Amazon. Vous pouvez également continuer à utiliser la console X-Ray.

Options de règle d'échantillonnage

Les options suivantes sont disponibles pour chaque règle. Les valeurs de chaîne peuvent comporter des caractères génériques correspondant à un seul caractère (?) ou à zéro caractère ou plus (*).

Exemples de règles d'échantillonnage

Configurez votre service pour utiliser les règles d'échantillonnage

Le SDK X-Ray nécessite une configuration supplémentaire pour utiliser les règles d'échantillonnage que vous configurez dans la console. Consultez la rubrique de configuration de votre langage pour en savoir plus sur la configuration d'une stratégie d'échantillonnage :

Pour API Gateway, consultezSupport de suivi actif d'Amazon API Gateway pour AWS X-Ray.

Affichage des résultats d'échantillonnage

La page d'échantillonnage de la console X-Ray affiche des informations détaillées sur la manière dont vos services utilisent chaque règle d'échantillonnage.

La colonne Trend (Tendance) montre comment la règle a été utilisé au cours des dernières minutes. Chaque colonne indique les statistiques pour une fenêtre de 10 secondes.

Pour plus d'informations sur l'échantillonnage des statistiques et la façon dont les services utilisent les règles d'échantillonnage, consultez Utilisation de règles d'échantillonnage avec l'API X-Ray.

Étapes suivantes

Vous pouvez utiliser l'API X-Ray pour gérer les règles d'échantillonnage. Avec l'API, vous pouvez créer et mettre à jour les règles par programmation ou en fonction d'une planification, en réponse à des alarmes ou à des notifications. Consultez Configuration des paramètres d'échantillonnage, de groupes et de chiffrement avec l'API X-Ray pour obtenir des instructions et des exemples de règles supplémentaires.

Le SDK X-Ray peut Services AWS également utiliser l'API X-Ray pour lire les règles d'échantillonnage, communiquer les résultats d'échantillonnage et obtenir des cibles d'échantillonnage. Les services doivent suivre la fréquence à laquelle ils appliquent chaque règle, évaluer les règles en fonction de leur priorité et emprunter auprès du réservoir lorsqu'une demande correspond à une règle pour laquelle X-Ray n'a pas encore attribué de quota au service. Pour plus de détails sur la manière dont un service utilise l'API pour l'échantillonnage, consultezUtilisation de règles d'échantillonnage avec l'API X-Ray.

Lorsque le SDK X-Ray appelle des API d'échantillonnage, il utilise le daemon X-Ray comme proxy. Si vous utilisez déjà le port TCP 2000, vous pouvez configurer le démon pour exécuter le proxy sur un autre port. Consultez Configuration du AWS X-Ray daemon pour plus de détails.

Vous pouvez utiliser des itinéraires et des requêtes pour créer des liens profonds vers des traces spécifiques, ou des vues filtrées des traces et de la carte des traces.

Suivis

Vous pouvez générer des liens pour des vues chronologiques, brutes et de cartographie de suivis individuels.

Tracez la chronologie — xray/home#/traces/trace-id

Données de trace brutes — xray/home#/traces/trace-id/raw

https://console.aws.amazon.com/xray/home#/traces/1-57f5498f-d91047849216d0f2ea3b6442/raw

Expressions de filtrage

Lien vers une liste filtrée de suivis.

Affichage des traces filtrées — xray/home#/traces?filter=filter-expression

https://console.aws.amazon.com/xray/home#/traces?filter=service("api.amazon.com") { fault = true OR responsetime > 2.5 } AND annotation.foo = "bar"

https://console.aws.amazon.com/xray/home#/traces?filter=service(%22api.amazon.com%22)%20%7B%20fault%20%3D%20true%20OR%20responsetime%20%3E%202.5%20%7D%20AND%20annotation.foo%20%3D%20%22bar%22

Pour plus d'informations sur les expressions de filtrage, consultez Utiliser des expressions de filtre.

Plage horaire

Spécifiez une durée ou une heure de début et de fin au format ISO8601. Les plages horaires sont exprimées en UTC et peuvent durer jusqu'à 6 heures.

Durée — xray/home#/page?timeRange=range-in-minutes

https://console.aws.amazon.com/xray/home#/service-map?timeRange=PT1H

Heure de début et de fin — xray/home#/page?timeRange=start~end

https://console.aws.amazon.com/xray/home#/traces?timeRange=2023-7-01T16:00:00~2023-7-01T22:00:00

https://console.aws.amazon.com/xray/home#/traces?timeRange=2023-7-01T16:00~2023-7-01T22:00

Région

Spécifiez un lien Région AWS vers les pages de cette région. Si vous n'indiquez pas de région, la console vous redirige vers la dernière région visitée.

Région — xray/home?region=region#/page

https://console.aws.amazon.com/xray/home?region=us-west-2#/service-map

Lorsque vous incluez une région avec d'autres paramètres de requête, la requête Region précède le hachage et les requêtes spécifiques aux rayons X suivent le nom de page.

https://console.aws.amazon.com/xray/home?region=us-west-2#/service-map?timeRange=PT1H

Combiné

https://console.aws.amazon.com/xray/home#/traces?timeRange=PT15M&filter=duration%20%3E%3D%205%20AND%20duration%20%3C%3D%208