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.
# Configuration du AWS X-Ray débogage
Vous pouvez utiliser la AWS Elastic Beanstalk console ou un fichier de configuration pour exécuter le AWS X-Ray démon sur les instances de votre environnement. X-Ray est un AWS service qui collecte des données sur les demandes traitées par votre application et les utilise pour créer une carte des services que vous pouvez utiliser pour identifier les problèmes liés à votre application et les opportunités d'optimisation.
**Note**
Certaines régions ne proposent pas X-Ray. Si vous créez un environnement dans l'une de ces régions, vous ne pouvez pas exécuter le démon X-Ray sur les instances dans votre environnement.
Pour plus d'informations sur les AWS services offerts dans chaque région, consultez le [tableau des régions](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/).
X-Ray fournit un kit de développement logiciel (SDK) que vous pouvez utiliser pour instrumentaliser votre code d'application et une application démon qui transmet les informations de débogage du SDK vers l'API X-Ray.
**Plateformes prises en charge**
Vous pouvez utiliser le kit SDK X-Ray avec les plateformes Elastic Beanstalk suivantes :
+ **Go** - Version 2.9.1 et ultérieure
+ **Java 8** - version 2.3.0 et ultérieures
+ **Java 8 avec Tomcat 8** - version 2.4.0 et ultérieures
+ **Node.js** - version 3.2.0 et ultérieures
+ **Windows Server** - toutes les versions de plateforme publiées le 18 décembre 2016 ou après cette date
+ **Python** version 2.5.0 et ultérieures
Sur les plateformes prises en charge, vous pouvez utiliser une option de configuration pour exécuter le démon X-Ray sur les instances de votre environnement. Vous pouvez activer le démon dans la [console Elastic Beanstalk](#environment-configuration-debugging-console) ou à l'aide d'un [fichier de configuration](#environment-configuration-debugging-namespace).
Pour télécharger des données vers X-Ray, le daemon X-Ray nécessite des autorisations IAM dans la politique **AWSXrayWriteOnlyAccess**gérée. Ces autorisations sont incluses dans [le profil d'instance Elastic Beanstalk](concepts-roles-instance.md). Si vous n'utilisez pas le profil d'instance par défaut, veuillez consulter [Autorisation du démon à envoyer des données à X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-daemon.html#xray-daemon-permissions) dans le *Guide du développeur AWS X-Ray *.
Le débogage avec X-Ray nécessite l'utilisation du kit SDK X-Ray. Pour obtenir des instructions et des exemples d'applications, veuillez consulter [Mise en route avec AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-gettingstarted.html) dans le *Guide du développeur AWS X-Ray *.
Si vous utilisez une version de plateforme qui n'inclut pas le démon, vous pouvez malgré tout l'exécuter avec un script dans un fichier de configuration. Pour de plus amples informations, veuillez consulter [ Téléchargement et exécution du Démon X-Ray manuellement (avancé)](https://docs.aws.amazon.com/xray/latest/devguide/xray-daemon-beanstalk.html#xray-daemon-beanstalk-manual) dans le *Guide du développeur AWS X-Ray *.
**Topics**
+ [Configuration du débogage](#environment-configuration-debugging-console)
+ [Espace de noms aws:elasticbeanstalk:xray](#environment-configuration-debugging-namespace)
## Configuration du débogage
Vous pouvez activer le démon X-Ray sur un environnement en cours d'exécution dans la console Elastic Beanstalk.
**Pour activer le débogage dans la console Elastic Beanstalk**
1. Ouvrez la console [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk), puis **dans la liste des régions, sélectionnez votre**. Région AWS
1. Dans le panneau de navigation, choisissez **Environments** (Environnements), puis choisissez le nom de votre environnement dans la liste.
1. Dans le panneau de navigation, choisissez **Configuration**.
1. Dans la catégorie de configuration **Mises à jour, surveillance et journalisation**, sélectionnez **Modifier**.
1. Dans la section **Amazon X-Ray**, sélectionnez **Activé**.
1. Pour enregistrer les modifications, cliquez sur **Appliquer** en bas de la page.
Vous pouvez également activer cette option lors de la création de l'environnement. Pour de plus amples informations, veuillez consulter [Assistant de création d'un environnement](environments-create-wizard.md).
## Espace de noms aws:elasticbeanstalk:xray
Vous pouvez utiliser l'option `XRayEnabled` dans l'espace de noms `aws:elasticbeanstalk:xray` pour activer le débogage.
Pour activer automatiquement le débogage lorsque vous déployez votre application, définissez l'option dans un [fichier de configuration](ebextensions.md) dans votre code source, comme suit.
**Example .ebextensions/debugging.config**
```
option_settings:
aws:elasticbeanstalk:xray:
XRayEnabled: true
```