Configuration du débogage AWS X-Ray

Vous pouvez utiliser la console AWS Elastic Beanstalk ou un fichier de configuration pour exécuter le démon AWS X-Ray sur les instances de votre environnement. X-Ray est un service AWS qui collecte des données sur les demandes traitées par votre application et les utilise pour construire une cartographie des services qui vous permet d'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 de plus amples informations sur les services AWS proposés dans chaque région, veuillez consulter le Tableau des régions.

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 ou à l'aide d'un fichier de configuration.

Pour pouvoir charger des données dans X-Ray, le démon X-Ray nécessite des autorisations IAM dans la stratégie gérée AWSXrayWriteOnlyAccess. Ces autorisations sont incluses dans le profil d'instance Elastic Beanstalk. Si vous n'utilisez pas le profil d'instance par défaut, veuillez consulter Autorisation du démon à envoyer des données à X-Ray 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 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é) dans le Guide du développeur AWS X-Ray.

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 et, dans la liste Regions (Régions), sélectionnez votre Région AWS.

2. Dans le panneau de navigation, choisissez Environments (Environnements), puis choisissez le nom de votre environnement dans la liste.

   Note

   Si vous avez plusieurs environnements, utilisez la barre de recherche pour filtrer la liste des environnements.

3. Dans le panneau de navigation, choisissez Configuration.

4. Dans la catégorie de configuration Mises à jour, surveillance et journalisation, sélectionnez Modifier.

5. Dans la section Amazon X-Ray, sélectionnez Activé.

6. 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.

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 dans votre code source, comme suit.

Exemple .ebextensions/debugging.config

option_settings:
  aws:elasticbeanstalk:xray:
    XRayEnabled: true