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.
Utilisez un AWS Management Console
AWS Management Console Si vous le souhaitez, utilisez une interface utilisateur graphique (GUI) nécessitant un minimum de codage. Les utilisateurs qui découvrent X-Ray peuvent se lancer rapidement à l'aide de visualisations prédéfinies et à effectuer des tâches de base. Vous pouvez effectuer les opérations suivantes directement depuis la console :
-
Activez X-Ray.
-
Consultez des résumés de haut niveau des performances de votre application.
-
Vérifiez l'état de santé de vos applications.
-
Identifiez les erreurs de haut niveau.
-
Consultez les résumés des traces de base.
Vous pouvez utiliser la CloudWatch console Amazon sur https://console.aws.amazon.com/cloudwatch/
Utiliser la CloudWatch console Amazon
La CloudWatch console inclut une nouvelle fonctionnalité X-Ray qui a été repensée par rapport à la console X-Ray pour en faciliter l'utilisation. Si vous utilisez la CloudWatch console, vous pouvez consulter les CloudWatch journaux et les métriques ainsi que les données de suivi de X-Ray. Utilisez la CloudWatch console pour afficher et analyser les données, notamment les suivantes :
-
X-Ray Traces : visualisez, analysez et filtrez les traces associées à votre application lorsqu'elle répond à une demande. Utilisez ces traces pour détecter les latences élevées, les erreurs de débogage et optimiser le flux de travail de votre application. Consultez une carte de trace et une carte des services pour obtenir des représentations visuelles du flux de travail de votre application.
-
Journaux : affichez, analysez et filtrez les journaux produits par votre application. Utilisez les journaux pour résoudre les erreurs et configurez la surveillance en fonction de valeurs de journal spécifiques.
-
Métriques : mesurez et surveillez les performances de vos applications à l'aide de métriques émises par vos ressources ou créez vos propres métriques. Affichez ces indicateurs sous forme de graphiques et de tableaux.
-
Surveillance des réseaux et de l'infrastructure : surveillez les principaux réseaux pour détecter les pannes, ainsi que l'état et les performances de votre infrastructure, y compris les applications conteneurisées, les autres AWS services et les clients.
-
Toutes les fonctionnalités de la console X-Ray sont répertoriées dans la section Utiliser la console X-Ray suivante.
Pour plus d'informations sur la CloudWatch console, consultez Getting started with Amazon CloudWatch.
Connectez-vous à la CloudWatch console Amazon à l'adresse https://console.aws.amazon.com/cloudwatch/
Utiliser la console X-Ray
La console X-Ray propose un suivi distribué pour les demandes d'applications. Utilisez la console X-Ray si vous souhaitez une expérience de console plus simple ou si vous ne souhaitez pas mettre à jour le code de votre application. AWS ne développe plus la console X-Ray. La console X-Ray contient les fonctionnalités suivantes pour les applications instrumentées :
-
Informations : détectez automatiquement les anomalies dans les performances de votre application et identifiez les causes sous-jacentes. Les informations sont incluses dans la CloudWatch console sous Insights. Pour plus d'informations, consultez la section Utiliser X-Ray Insights dansDécouvrez la console X-Ray.
-
Carte des services : affichez une structure graphique de votre application et de ses connexions avec les clients, les ressources, les services et les dépendances.
-
Traces — Consultez un aperçu des traces générées par votre application lorsqu'elle répond à une demande. Utilisez les données de suivi pour comprendre les performances de votre application par rapport aux indicateurs de base, notamment le temps de HTTP réponse et le temps de réponse.
-
Analyses — Interprétez, explorez et analysez les données de suivi à l'aide de graphiques pour la distribution des temps de réponse.
-
Configuration — Créez des traces personnalisées pour modifier les configurations par défaut pour les éléments suivants :
-
Échantillonnage : créez une règle qui définit la fréquence à laquelle vous devez échantillonner votre application pour obtenir des informations de suivi. Pour plus d'informations, consultez la section Configurer les règles d'échantillonnage dansDécouvrez la console X-Ray.
-
Chiffrement — Chiffrez les données au repos à l'aide d'une clé que vous pouvez auditer ou désactiver à l'aide AWS Key Management Service d'une clé.
-
Groupes : utilisez une expression de filtre pour définir un groupe de traces présentant une caractéristique commune, telle que le nom d'une URL ou un temps de réponse. Pour plus d'informations, consultez la section Configuration des groupes.
-
Connectez-vous à la console X-Ray à l'adresse https://console.aws.amazon.com/xray/home
Découvrez la console X-Ray
Utilisez la console X-Ray pour afficher une carte des services et des traces associées aux demandes traitées par vos applications, et pour configurer les groupes et les règles d'échantillonnage qui affectent la manière dont les traces sont envoyées à X-Ray.
Note
La carte et CloudWatch ServiceLens la carte X-Ray Service ont été combinées dans la carte de trace X-Ray dans la CloudWatch console Amazon. Ouvrez la CloudWatchconsole
CloudWatch inclut désormais Application Signals, qui permet de découvrir et de surveiller les services de votre application, vos clients, les canaries Synthetics et les dépendances des services. Utilisez Application Signals pour consulter une liste ou une carte visuelle de vos services, consulter les métriques d’intégrité en fonction de vos objectifs de niveau de service (SLO) et effectuer une analyse descendante pour voir les suivis X-Ray corrélés afin de résoudre les problèmes de manière plus détaillée.
La page principale de la console X-Ray est la carte de trace, qui est une représentation visuelle du graphe de service JSON généré par X-Ray à partir des données de suivi générées par vos applications. La cartographie se compose de nœuds de service pour chaque application de votre compte qui sert des demandes, de nœuds clients en amont qui représentent les origines des demandes et de nœuds de service en aval qui représentent les services web et les ressources utilisées par une application lors du traitement d'une demande. Des pages supplémentaires permettent d'afficher les traces et les détails des traces, ainsi que de configurer les groupes et les règles d'échantillonnage.
Consultez l'expérience de X-Ray sur console et comparez-la avec la CloudWatch console dans les sections suivantes.
Découvrez le X-Ray et les CloudWatch consoles
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.
Note
CloudWatch inclut désormais Application Signals, qui permet de découvrir et de surveiller les services, les clients, les canaris synthétiques et les dépendances des services de votre application. Utilisez Application Signals pour consulter une liste ou une carte visuelle de vos services, consulter les métriques d’intégrité en fonction de vos objectifs de niveau de service (SLO) et effectuer une analyse descendante pour voir les suivis X-Ray corrélés afin de résoudre les problèmes de manière plus détaillée.
La carte et CloudWatch ServiceLens la carte du service X-Ray sont combinées dans la carte de trace X-Ray dans la CloudWatch console Amazon. Ouvrez la CloudWatchconsole
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.
Note
La carte de trace X-Ray peut afficher jusqu'à 10 000 nœuds. Dans de rares cas où le nombre total de nœuds de service dépasse cette limite, il est possible que vous receviez une erreur et que vous ne puissiez pas afficher une carte de suivi complète dans la console.
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 :
-
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 erreurs et défauts éventuels.
-
L'onglet Ressources d'un segment affiche des informations provenant du SDK X-Ray et des AWS ressources qui exécutent votre application. Utilisez les plug-ins Amazon EC2 ou Amazon ECS pour le SDK X-Ray afin d'enregistrer des informations sur les ressources spécifiques au service. AWS Elastic Beanstalk Pour plus d'informations sur les plug-ins, consultez la section Plug-ins de service dansConfiguration du SDK X-Ray pour Java.
-
Les autres onglets affichent 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 SDK X-Ray. Pour ajouter des annotations ou des métadonnées à vos segments, utilisez le SDK X-Ray. Pour plus d'informations, consultez le lien spécifique à la langue répertorié sous Instrumentation de votre application avec AWS X-Ray des SDK. Instrumentez 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 Vue d'ensemble 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 erreurs et défauts éventuels. 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 détaillées sur les AWS ressources 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 affichent 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 SDK X-Ray. Utilisez le SDK X-Ray 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 avec AWS X-Ray des SDK. Instrumentez 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 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înetrue
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.
— Valeur d'une annotation aveckey
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 leedge
mot cléservice
or. -
edge(
— Connexion entre lasource
,destination
) {filter
}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.
— La valeur de l'expression de filtre d'un groupe, référencée par le nom ou l'ARN du groupe.name
/ group.arn
-
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(
— Service avec nom etname
) {filter
}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(
— Connexion entre lasource
,destination
) {filter
}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.
— Valeur d'une annotation aveckey
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 leedge
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.
est défini ou utiliser les opérateurs de comparaison correspondant au type de valeur.key
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 :
-
Métriques sur Amazon CloudWatch
-
Groupes de journaux dans Amazon CloudWatch Logs
-
Traces dans AWS X-Ray
-
Applications dans Amazon CloudWatch Application Insights
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
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.
Note
Les tracés X-Ray sont facturés à l' Compte AWS endroit où ils sont reçus. Si une demande échantillonnée couvre plusieurs services Compte AWS, chaque compte enregistre une trace distincte, et toutes les traces partagent le même identifiant de trace. Pour en savoir plus sur la tarification de l'observabilité entre comptes, consultez les sections Tarification et AWS X-Ray Tarification
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.
Note
Chaque segment de trace peut être lié à un maximum de 20 traces, tandis qu'une trace peut inclure un maximum de 100 liens. Dans certains scénarios, l'association de traces supplémentaires peut entraîner le dépassement de la taille maximale du document de trace, ce qui peut entraîner une trace incomplète. Cela peut se produire, par exemple, lorsqu'une fonction Lambda dont le suivi est activé envoie de nombreux messages SQS à une file d'attente en un seul appel. Si vous rencontrez ce problème, une solution d'atténuation utilisant les SDK X-Ray est disponible. Consultez le SDK X-Ray pour Java
Afficher les traces liées dans la carte des traces
Utilisez la page Trace Map de la CloudWatchconsole
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é
Consultez les informations de suivi envoyées par un producteur de messages, une file d'attente Amazon SQS ou un client Lambda :
-
Utilisez la carte de suivi pour sélectionner un nœud producteur de messages, Amazon SQS ou consommateur Lambda.
-
Choisissez Afficher les traces dans le volet des détails du nœud pour afficher la liste des traces. Vous pouvez également accéder directement à la page Traces dans la CloudWatch console.
-
Choisissez une trace spécifique dans la liste pour ouvrir la page des détails de la trace. La page des détails de la trace affiche un message lorsque la trace sélectionnée fait partie d'un ensemble de traces liées.
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
Filtrez un ensemble de traces liées en une seule trace, pour voir les détails des segments dans la chronologie.
-
Choisissez Sélectionner une trace sous les traces liées sur la carte des détails de la trace. La liste des traces s'affiche.
-
Sélectionnez le bouton radio à côté d'une trace pour l'afficher dans la carte des détails de la trace.
-
Choisissez Annuler la sélection de traces pour afficher l'ensemble complet des 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.
-
Choisissez un nœud de service en cliquant sur le cercle. X-Ray affiche un histogramme des demandes traitées par le service. Les latences sont celles enregistrées par le service et n'incluent aucune latence réseau entre le service et le demandeur.
-
Choisissez une arête en cliquant sur le bout de la ligne ou de la flèche située entre deux services. X-Ray affiche un histogramme des demandes du demandeur qui ont été traitées par le service en aval. Les latences sont celles enregistrées par le demandeur et incluent les latences au niveau de la connexion réseau entre les deux services.
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 :
-
Identifiez l'endroit où les problèmes se produisent dans votre application, la cause première du problème et l'impact associé. L'analyse d'impact fournie par Insights vous permet de déterminer la gravité et la priorité d'un problème.
-
Recevez des notifications lorsque le problème évolue au fil du temps. Les notifications Insights peuvent être intégrées à votre solution de surveillance et d'alerte à l'aide d'Amazon EventBridge. Cette intégration vous permet d'envoyer des e-mails ou des alertes automatisés en fonction de la gravité du problème.
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.
Ouvrez la console X-Ray
. -
Sélectionnez un groupe existant ou créez-en un nouveau en choisissant Create group, puis en sélectionnant Enable Insights. Pour plus d'informations sur la configuration des groupes dans la console X-Ray, consultezConfiguration des groupes.
-
Dans le volet de navigation de gauche, choisissez Insights, puis choisissez un aperçu à afficher.
Note
X-Ray utilise GetInsightSummaries, GetInsight GetInsightEvents, et des opérations GetInsightImpactGraph d'API pour récupérer des données à partir d'informations. Pour consulter les informations, utilisez la stratégie gérée par AWSXrayReadOnlyAccess IAM ou ajoutez la politique personnalisée suivante à votre rôle IAM :
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "xray:GetInsightSummaries", "xray:GetInsight", "xray:GetInsightEvents", "xray:GetInsightImpactGraph" ], "Resource": [ "*" ] } ] }
Pour plus d’informations, consultez Comment AWS X-Ray fonctionne avec IAM.
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.
Pour activer les notifications pour un groupe X-Ray
Ouvrez la console X-Ray
. -
Sélectionnez un groupe existant ou créez-en un nouveau en choisissant Créer un groupe, assurez-vous que l'option Activer les informations est sélectionnée, puis sélectionnez Activer les notifications. Pour plus d'informations sur la configuration des groupes dans la console X-Ray, consultezConfiguration des groupes.
Pour configurer les règles EventBridge conditionnelles d'Amazon
-
Ouvrez la EventBridge console Amazon
. -
Accédez à Règles dans la barre de navigation de gauche, puis choisissez Créer une règle.
-
Donnez un nom et une description à la règle.
-
Choisissez Modèle d'événement, puis choisissez Modèle personnalisé. Fournissez un modèle contenant
"source": [ "aws.xray" ]
et"detail-type": [ "AWS X-Ray Insight Update" ]
. Voici quelques exemples de modèles possibles.-
Modèle d'événements correspondant à tous les événements entrants provenant de X-Ray Insights :
{ "source": [ "aws.xray" ], "detail-type": [ "AWS X-Ray Insight Update" ] }
-
Modèle d'événement correspondant à une valeur spécifiée
state
etcategory
:{ "source": [ "aws.xray" ], "detail-type": [ "AWS X-Ray Insight Update" ], "detail": { "State": [
"ACTIVE"
], "Category": ["FAULT"
] } }
-
-
Sélectionnez et configurez les cibles que vous souhaitez appeler lorsqu'un événement répond à cette règle.
-
(Facultatif) Fournissez des balises pour identifier et sélectionner plus facilement cette règle.
-
Choisissez Créer.
Note
Les notifications X-Ray Insights envoient des événements à Amazon EventBridge, qui ne prend actuellement pas en charge les clés gérées par les clients. Pour plus d’informations, consultez Protection des données dans AWS X-Ray.
Aperçu d'Insight
La page de présentation d'un aperçu tente de répondre à trois questions clés :
-
Quel est le problème sous-jacent ?
-
Quelle en est la cause première ?
-
Quel en est l'impact ?
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 :
-
Impact sur le groupe X-Ray. Pour plus d'informations, voir Configuration des groupes
-
Impact sur le service responsable
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 |
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.
Note
Les groupes sont facturés en fonction du nombre de suivis récupérés qui correspondent à l'expression de filtrage. Pour en savoir plus, consultez AWS X-Ray Tarification
Créez un groupe
Note
Vous pouvez désormais configurer les groupes X-Ray depuis la CloudWatch console Amazon. Vous pouvez également continuer à utiliser la console X-Ray.
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 :
-
API Gateway Entrypoint : API Gateway prend en charge l'échantillonnage et le suivi actif. Pour activer le suivi actif sur une étape d'API, consultez Support de suivi actif d'Amazon API Gateway pour AWS X-Ray.
-
AWS AppSync— AWS AppSync prend en charge l'échantillonnage et le traçage actif. Pour activer le suivi actif des AWS AppSync demandes, voir Tracing with AWS X-Ray.
-
SDK Instrument X-Ray sur des plateformes informatiques : lorsque vous utilisez des plateformes de calcul telles qu'Amazon EC2, Amazon ECS AWS Elastic Beanstalk ou, l'échantillonnage est pris en charge lorsque l'application a été instrumentée avec le dernier SDK X-Ray.
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.
Note
X-Ray applique les règles d'échantillonnage dans la mesure du possible et, dans certains cas, le taux d'échantillonnage effectif peut ne pas correspondre exactement aux règles d'échantillonnage configurées. Cependant, au fil du temps, le nombre de demandes échantillonnées devrait être proche du pourcentage configuré.
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 (*
).
Options de règle d'échantillonnage
-
Nom de la règle (chaîne) : nom unique de la règle.
-
Priorité (entier compris entre 1 et 9999) : priorité de la règle d'échantillonnage. Les services évaluent les règles dans l'ordre croissant de priorité, et prennent une décision d'échantillonnage avec la première règle correspondante.
-
Réservoir (entier non négatif) — Nombre fixe de demandes correspondantes à l'instrument par seconde, avant l'application du taux fixe. Le réservoir n'est pas utilisé directement par les services, mais s'applique à tous les services qui utilisent la règle collectivement.
-
Taux (entier compris entre 0 et 100) : pourcentage de demandes correspondantes à l'instrument, une fois le réservoir épuisé. Lorsque vous configurez une règle d'échantillonnage dans la console, choisissez un pourcentage compris entre 0 et 100. Lorsque vous configurez une règle d'échantillonnage dans un SDK client à l'aide d'un document JSON, fournissez une valeur en pourcentage comprise entre 0 et 1.
-
Nom du service (chaîne) : nom du service instrumenté, tel qu'il apparaît sur la carte de suivi.
-
X-Ray SDK : nom du service que vous configurez sur l'enregistreur.
-
Amazon API Gateway —
.api-name
/stage
-
-
Type de service (chaîne) : type de service tel qu'il apparaît sur la carte de suivi. Pour le SDK X-Ray, définissez le type de service en appliquant le plug-in approprié :
-
AWS::ElasticBeanstalk::Environment
— Un AWS Elastic Beanstalk environnement (plugin). -
AWS::EC2::Instance
— Une instance Amazon EC2 (plugin). -
AWS::ECS::Container
— Un conteneur Amazon ECS (plugin). -
AWS::APIGateway::Stage
— Une étape Amazon API Gateway. -
AWS::AppSync::GraphQLAPI
— Une demande AWS AppSync d'API.
-
-
Host (chaîne) — Le nom d'hôte indiqué dans l'en-tête de l'hôte HTTP.
-
Méthode HTTP (chaîne) — Méthode de la requête HTTP.
-
Chemin de l'URL (chaîne) — Le chemin URL de la demande.
-
X-Ray SDK : partie du chemin de l'URL de la requête HTTP.
-
-
ARN de la ressource (chaîne) — L'ARN de la AWS ressource exécutant le service.
-
X-Ray SDK — Non pris en charge. Le kit SDK peut uniquement utiliser des règles avec les ressources ARN définies sur
*
. -
Amazon API Gateway — L'ARN du stage.
-
-
(Facultatif) Attributs (clé et valeur) — Attributs de segment connus lorsque la décision d'échantillonnage est prise.
-
X-Ray SDK — Non pris en charge. Le kit SDK ignore les règles qui spécifient les attributs.
-
Amazon API Gateway — En-têtes issus de la requête HTTP d'origine.
-
Exemples de règles d'échantillonnage
Exemple — Règle par défaut sans réservoir et faible taux
Vous pouvez modifier le réservoir et la fréquence de la règle par défaut. Par défaut, la règle s'applique à toutes les demandes qui ne correspond à aucune autre règle.
-
Réservoir :
0
-
Taux :
5
(0.05
si configuré à l'aide d'un document JSON)
Exemple — Règle de débogage pour suivre toutes les demandes relatives à un itinéraire problématique
Une règle prioritaire est appliquée temporairement pour le débogage.
-
Nom de la règle :
DEBUG – history updates
-
Priorité :
1
-
Réservoir :
1
-
Taux :
100
(1
si configuré à l'aide d'un document JSON) -
Nom du service :
Scorekeep
-
Type de service :
*
-
Hôte :
*
-
Méthode HTTP :
PUT
-
Chemin de l'URL :
/history/*
-
ARN de la ressource :
*
Exemple — Taux minimum plus élevé pour les POST
-
Nom de la règle :
POST minimum
-
Priorité :
100
-
Réservoir :
10
-
Taux :
10
(.1
si configuré à l'aide d'un document JSON) -
Nom du service :
*
-
Type de service :
*
-
Hôte :
*
-
Méthode HTTP :
POST
-
Chemin de l'URL :
*
-
ARN de la ressource :
*
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 :
-
Java: Règles d'échantillonnage
-
Allez : Règles d'échantillonnage
-
Node.js : Règles d'échantillonnage
-
Python: Règles d'échantillonnage
-
Rubis : Règles d'échantillonnage
-
.NET : Règles 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.
Échantillonnage des statistiques
-
Règle correspondante totale : nombre de demandes correspondant à cette règle. Ce nombre n'inclut pas les demandes qui pourraient avoir une correspondance avec cette règle, mais celles qui ont en premier une règle de priorité.
-
Total échantillonné : nombre de demandes enregistrées.
-
Échantillonné avec un taux fixe : nombre de demandes échantillonnées en appliquant le taux fixe de la règle.
-
Échantillonné avec limite de réservoir : nombre de demandes échantillonnées à l'aide d'un quota attribué par X-Ray.
-
Emprunté au réservoir : nombre de demandes échantillonnées en empruntant auprès du réservoir. La première fois qu'un service fait correspondre une demande à une règle, aucun quota ne lui a encore été attribué par X-Ray. Toutefois, si le réservoir est d'au moins 1, le service emprunte une trace par seconde jusqu'à ce que X-Ray attribue un quota.
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.
Pages de console
-
Page d'accueil — xray/home#/welcome
-
Mise en route — xray/home#/getting-started
-
Carte de suivi — xray/home#/service-map
-
Traces — xray/home#/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
Exemple — données de trace brutes
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
Exemple — expression de filtre
https://console.aws.amazon.com/xray/home#/traces?filter=service("api.amazon.com") { fault = true OR responsetime > 2.5 } AND annotation.foo = "bar"
Exemple — expression de filtre (encodée en URL)
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
Exemple — carte de traçage de la dernière heure
https://console.aws.amazon.com/xray/home#/service-map?timeRange=PT1H
Heure de début et de fin — xray/home#/
page
?timeRange=start
~end
Exemple — plage de temps précise en secondes
https://console.aws.amazon.com/xray/home#/traces?timeRange=2023-7-01T16:00:00~2023-7-01T22:00:00
Exemple — plage de temps précise en minutes
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
Exemple — carte de traçage dans l'ouest des États-Unis (Oregon) (us-west-2)
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.
Exemple — carte de suivi de la dernière heure dans l'ouest des États-Unis (Oregon) (us-west-2)
https://console.aws.amazon.com/xray/home?region=us-west-2#/service-map?timeRange=PT1H
Combiné
Exemple — traces récentes avec filtre de durée
https://console.aws.amazon.com/xray/home#/traces?timeRange=PT15M&filter=duration%20%3E%3D%205%20AND%20duration%20%3C%3D%208
Sortie
-
Page — Traces
-
Plage de temps — 15 dernières minutes
-
Filtre — durée >= 5 ET durée <= 8