

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.

# CloudWatch intégration avec X-Ray
<a name="xray-services-cloudwatch"></a>

AWS X-Ray s'intègre à [CloudWatch Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html), CloudWatch RUM et CloudWatch Synthetics pour faciliter le suivi de l'état de vos applications. Activez votre application pour Application Signals afin de surveiller et de résoudre les problèmes liés à l'état de fonctionnement de vos services, de vos pages clients, des canaries Synthetics et des dépendances des services.

En corrélant CloudWatch les métriques, les journaux et les traces X-Ray, la carte de suivi X-Ray fournit une end-to-end vue de vos services pour vous aider à identifier rapidement les problèmes de performance et à identifier les utilisateurs concernés.

Avec CloudWatch RUM, vous pouvez effectuer une surveillance réelle des utilisateurs afin de collecter et de visualiser les données côté client concernant les performances de votre application Web à partir de sessions utilisateur réelles en temps quasi réel. Avec AWS X-Ray et CloudWatch RUM, vous pouvez analyser et déboguer le chemin de la demande en commençant par les utilisateurs finaux de votre application via les services AWS gérés en aval. Cela vous permet d’identifier les tendances de latence et les erreurs qui ont un impact sur les utilisateurs finaux. 

**Topics**
+ [CloudWatch RUM et AWS X-Ray](xray-services-RUM.md)
+ [Déboguer des canaris CloudWatch synthétiques à l'aide de X-Ray](xray-services-cloudwatch-synthetics.md)

# CloudWatch RUM et AWS X-Ray
<a name="xray-services-RUM"></a>

Avec Amazon CloudWatch RUM, vous pouvez effectuer une surveillance réelle des utilisateurs afin de collecter et de consulter les données côté client concernant les performances de votre application Web à partir de sessions utilisateur réelles en temps quasi réel. Avec AWS X-Ray et CloudWatch RUM, vous pouvez analyser et déboguer le chemin de la demande en commençant par les utilisateurs finaux de votre application via les services AWS gérés en aval. Cela vous permet d’identifier les tendances de latence et les erreurs qui ont un impact sur les utilisateurs finaux. 

Une fois que vous avez activé le suivi des sessions utilisateur par X-Ray, CloudWatch RUM ajoute un en-tête de trace X-Ray aux requêtes HTTP autorisées et enregistre un segment X-Ray pour les requêtes HTTP autorisées. Vous pouvez ensuite voir les traces et les segments de ces sessions utilisateur dans le X-Ray et les CloudWatch consoles, y compris la carte de suivi X-Ray. 

**Note**  
CloudWatch RUM ne s'intègre pas aux règles d'échantillonnage X-Ray. Choisissez plutôt un pourcentage d'échantillonnage lorsque vous configurez votre application pour utiliser CloudWatch RUM. Les traces envoyées depuis CloudWatch RUM peuvent entraîner des frais supplémentaires. Pour en savoir plus, consultez [Pricing AWS X-Ray](https://aws.amazon.com/xray/pricing/) (Tarification). 

Par défaut, les traces côté client envoyées depuis CloudWatch RUM ne sont pas connectées aux traces côté serveur. Pour connecter les traces côté client aux traces côté serveur, configurez le client Web CloudWatch RUM pour ajouter un en-tête de trace X-Ray à ces requêtes HTTP. 

**Avertissement**  
La configuration du client Web CloudWatch RUM pour ajouter un en-tête de trace X-Ray aux requêtes HTTP peut entraîner l'échec du partage de ressources entre origines (CORS). Pour éviter cela, ajoutez l'en-tête `X-Amzn-Trace-Id` HTTP à la liste des en-têtes autorisés dans la configuration CORS de votre service en aval. Si vous utilisez API Gateway en aval, consultez la section [Activation de CORS pour une ressource d'API REST](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-cors.html). Nous vous recommandons fortement de tester votre application avant d'ajouter un en-tête de suivi X-Ray côté client dans un environnement de production. Pour plus d'informations, consultez la [documentation du client Web CloudWatch RUM](https://github.com/aws-observability/aws-rum-web/blob/main/docs/cdn_installation.md#http).

Pour plus d'informations sur la surveillance des utilisateurs réels dans CloudWatch, voir [Utiliser CloudWatch RUM](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM.html). Pour configurer votre application pour utiliser CloudWatch RUM, y compris le suivi des sessions utilisateur avec X-Ray, voir [Configurer une application pour utiliser CloudWatch RUM](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM-get-started.html). 

# Déboguer des canaris CloudWatch synthétiques à l'aide de X-Ray
<a name="xray-services-cloudwatch-synthetics"></a>

CloudWatch Synthetics est un service entièrement géré qui vous permet de surveiller vos terminaux APIs et d'utiliser des canaries scriptés qui s'exécutent 24 heures par jour, une fois par minute. 

Vous pouvez personnaliser les scripts canari pour vérifier les changements en termes de : 
+ Disponibilité
+ Latence
+ Transactions
+ Liens brisés ou morts
+ Step-by-step achèvement des tâches
+ Erreurs de chargement de page
+ Latences de chargement pour les actifs de l'interface utilisateur
+ Flux d'assistants complexes
+ Flux de caisse dans votre application

Les scripts canaris suivent les mêmes itinéraires et effectuent les mêmes actions et comportements que vos clients, et vérifient continuellement l'expérience client.

Pour en savoir plus sur la configuration des tests Synthetics, consultez [Utilisation des synthétiques pour créer et gérer des scripts canaris](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html).

![\[Exemple de nœud canary dans la carte de suivi X-Ray.\]](http://docs.aws.amazon.com/fr_fr/xray/latest/devguide/images/synthetics-show-canary-active.png)


Les exemples suivants montrent des cas d'utilisation courants pour les problèmes de débogage que vos scripts canaris Synthetics soulèvent. Chaque exemple illustre une stratégie clé pour le débogage à l'aide de la carte de trace ou de la console X-Ray Analytics.

Pour plus d'informations sur la façon de lire et d'interagir avec la carte de trace, consultez la section [Affichage de la carte des services](https://docs.aws.amazon.com/xray/latest/devguide/xray-console.html#xray-console-servicemap). 

Pour plus d'informations sur la façon de lire et d'interagir avec la console X-Ray Analytics, consultez [Interaction avec la console AWS X-Ray Analytics](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-analytics.html). 

**Topics**
+ [Afficher les canaris avec un nombre accru de rapports d'erreurs sur la carte de suivi](#xray-services-cloudwatch-synthetics-workflows-which-canary)
+ [Utilisez des cartes détaillées pour les traces individuelles afin de visualiser chaque demande en détail](#xray-services-cloudwatch-synthetics-workflows-trace-map)
+ [Détermination de la cause racine des défaillances en cours dans les services en amont et en aval](#xray-services-cloudwatch-synthetics-workflows-root-cause)
+ [Identification des goulets d'étranglement et les tendances en matière de performances](#xray-services-cloudwatch-synthetics-workflows-bottlenecks)
+ [Comparaison des taux de latence et d'erreur ou d'erreur avant et après les modifications](#xray-services-cloudwatch-synthetics-workflows-latency)
+ [Déterminer la couverture canarienne requise pour tous APIs et URLs](#xray-services-cloudwatch-synthetics-workflows-impact)
+ [Utilisation des groupes pour se concentrer sur les tests synthétiques](#xray-services-cloudwatch-synthetics-groups)

## Afficher les canaris avec un nombre accru de rapports d'erreurs sur la carte de suivi
<a name="xray-services-cloudwatch-synthetics-workflows-which-canary"></a>

 [Pour voir quels canaris présentent une augmentation du nombre d'erreurs, de défaillances, de taux de limitation ou de temps de réponse lents sur votre carte de suivi X-Ray, vous pouvez mettre en évidence les nœuds clients Synthetics Canary à l'aide du filtre. `Client::Synthetic`](xray-console-filters.md) Cliquez sur un nœud pour afficher la distribution du temps de réponse de l'ensemble de la demande. Cliquez sur une arête entre deux nœuds pour afficher des informations détaillées sur les demandes ayant transité par cette connexion. Vous pouvez également afficher les nœuds inférés « distants » pour les services en aval associés sur votre carte de trace. 

Lorsque vous cliquez sur le nœud Synthetics, un bouton **Afficher dans Synthetics** se trouve sur le panneau latéral qui vous redirige vers la console Synthetics où vous pouvez consulter les détails de Canary.

![\[Exemple de nœud canari sur une carte de traçage aux rayons X avec les détails du service.\]](http://docs.aws.amazon.com/fr_fr/xray/latest/devguide/images/synthetics-canary-servicedetail.png)


## Utilisez des cartes détaillées pour les traces individuelles afin de visualiser chaque demande en détail
<a name="xray-services-cloudwatch-synthetics-workflows-trace-map"></a>

Pour déterminer quel service entraîne le plus de latence ou est à l'origine d'une erreur, appelez la carte des détails du suivi en sélectionnant le tracé dans la carte de suivi. Les cartes détaillées des traces individuelles indiquent le end-to-end chemin d'une seule demande. Utilisez cette option pour comprendre les services invoqués et visualiser les services en amont et en aval.

![\[Exemple de nœud canari sur la carte détaillée des tracés aux rayons X.\]](http://docs.aws.amazon.com/fr_fr/xray/latest/devguide/images/synthetics-canary-tracemap.png)


## Détermination de la cause racine des défaillances en cours dans les services en amont et en aval
<a name="xray-services-cloudwatch-synthetics-workflows-root-cause"></a>

Une fois que vous avez reçu une CloudWatch alarme signalant une défaillance d'un Synthetics Canary, utilisez la modélisation statistique des données de trace dans X-Ray pour déterminer la cause première probable du problème dans la console X-Ray Analytics. Dans la console Analytics, le tableau **Response Time Root Cause** indique les 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. 

L'exemple suivant montre que le test Synthetics pour l'API « XXX » exécuté sur API Gateway échoue en raison d'une exception de capacité de débit provenant de la table Amazon DynamoDB.

![\[Exemple de nœud canary dans la carte de suivi X-Ray.\]](http://docs.aws.amazon.com/fr_fr/xray/latest/devguide/images/synthetics-canary-active-select.png)


![\[Exemple de cause racine du nœud canary.\]](http://docs.aws.amazon.com/fr_fr/xray/latest/devguide/images/synthetics-canary-rootcause.png)


![\[Exemple de filtre d'annotation indiquant le nœud Canary.\]](http://docs.aws.amazon.com/fr_fr/xray/latest/devguide/images/synthetics-canary-showannot.png)


## Identification des goulets d'étranglement et les tendances en matière de performances
<a name="xray-services-cloudwatch-synthetics-workflows-bottlenecks"></a>

Vous pouvez visualiser les tendances des performances de votre terminal au fil du temps en utilisant le trafic continu provenant de vos canaris Synthetics pour remplir une carte des détails des traces sur une période donnée. 

![\[Exemple de filtre d'annotation indiquant le nœud Canary.\]](http://docs.aws.amazon.com/fr_fr/xray/latest/devguide/images/synthetics-canary-distribution.png)


## Comparaison des taux de latence et d'erreur ou d'erreur avant et après les modifications
<a name="xray-services-cloudwatch-synthetics-workflows-latency"></a>

Pincez l'heure à laquelle un changement s'est produit pour corréler ce changement à une augmentation du nombre de problèmes détectés par vos canaris. Utilisez la console X-Ray Analytics pour définir les plages de temps avant et après comme des ensembles de traces différents, ce qui permet de différencier visuellement la distribution des temps de réponse.

![\[Exemple de filtre d'annotation indiquant le nœud Canary.\]](http://docs.aws.amazon.com/fr_fr/xray/latest/devguide/images/synthetics-canary-compare.png)


## Déterminer la couverture canarienne requise pour tous APIs et URLs
<a name="xray-services-cloudwatch-synthetics-workflows-impact"></a>

 Utilisez X-Ray Analytics pour comparer l'expérience des canarys avec les utilisateurs. L'interface utilisateur ci-dessous montre une ligne de tendance bleue pour les canarys et une ligne verte pour les utilisateurs. Vous pouvez également identifier que deux d'entre eux URLs ne sont pas soumis au test Canary.

![\[Exemple de filtre d'annotation indiquant le nœud Canary.\]](http://docs.aws.amazon.com/fr_fr/xray/latest/devguide/images/synthetics-canary-vs-customer.png)


## Utilisation des groupes pour se concentrer sur les tests synthétiques
<a name="xray-services-cloudwatch-synthetics-groups"></a>

 Vous pouvez créer un groupe X-Ray à l'aide d'une expression de filtre pour vous concentrer sur un certain ensemble de flux de travail, tels que les tests Synthetics pour l'application « www » en cours d'exécution. AWS Elastic Beanstalk Utilisez des [mots clés complexes](xray-console-filters.md#console-filters-complex) `service()` et `edge()` filtrez les services et les limites.

**Example Expression de filtre de groupe**  

```
"edge(id(name: "www", type: "client::Synthetics"), id(name: "www", type: "AWS::ElasticBeanstalk::Environment"))" 
```

![\[Exemple de nœuds pour Elastic Beanstalk www.\]](http://docs.aws.amazon.com/fr_fr/xray/latest/devguide/images/synthetics-canary-active-www.png)
