View a markdown version of this page

Commencer avec X-Ray - AWS X-Ray

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.

Commencer avec X-Ray

Note

X-Ray SDK/Daemon Avis de maintenance — Le 25 février 2026, il passera en mode maintenance, où les versions du X-Ray SDK et du démon AWS seront limitées pour résoudre uniquement les problèmes de sécurité. AWS X-Ray SDKs/Daemon Pour plus d'informations sur la chronologie du support, consultezChronologie du support pour le SDK et Daemon X-Ray. Nous vous recommandons de migrer vers OpenTelemetry. Pour plus d'informations sur la migration vers OpenTelemetry, consultez la section Migration d'une X-Ray instrumentation à OpenTelemetry une autre.

Pour l'utiliser X-Ray, procédez comme suit :

  1. Instrumentez votre application, ce qui X-Ray permet de suivre la façon dont votre application traite une demande.

    • Utilisez les X-Ray SDK, les X-Ray API ADOT ou les signaux CloudWatch d'application pour envoyer des données de trace à X-Ray. Pour plus d'informations sur l'interface à utiliser, consultezChoix d'une interface.

    Pour plus d'informations sur l'instrumentation, consultezInstrumentation de votre application pour AWS X-Ray.

  2. (Facultatif) Configurez X-Ray pour qu'il fonctionne avec d'autres Services AWS qui s'intègrent à X-Ray. Vous pouvez échantillonner des traces et ajouter des en-têtes aux demandes entrantes, exécuter un agent ou un collecteur et envoyer automatiquement des données de trace à X-Ray. Pour plus d’informations, consultez Intégration AWS X-Ray avec d'autres Services AWS.

  3. Déployez votre application instrumentée. Lorsque votre application reçoit des demandes, le X-Ray SDK enregistre les données de trace, de segment et de sous-segment. Au cours de cette étape, vous devrez peut-être également configurer une politique IAM et déployer un agent ou un collecteur.

    • Pour des exemples de scripts permettant de déployer une application à l'aide du SDK AWS Distro for OpenTelemetry (ADOT) et de l' CloudWatch agent sur différentes plateformes, consultez la section Scripts de démonstration d'application Signals.

    • Pour un exemple de script permettant de déployer une application à l'aide du X-Ray SDK et du X-Ray démon, consultez. AWS X-Ray exemple d'application

  4. (Facultatif) Ouvrez une console pour afficher et analyser les données. Vous pouvez voir une représentation graphique d'une carte de trace, d'une carte de service, etc. pour inspecter le fonctionnement de votre application. Utilisez les informations graphiques de la console pour optimiser, déboguer et comprendre votre application. Pour plus d'informations sur le choix d'une console, consultezUtiliser une console.

Le schéma suivant montre comment commencer à utiliser X-Ray :

X-Ray affiche des informations détaillées sur les demandes de candidature, notamment leur statut, leur durée et le code de réponse HTTP.

Pour obtenir un exemple des données et des cartes disponibles dans la console, lancez un exemple d'application déjà instrumenté pour générer des données de trace. En quelques minutes, vous pouvez générer du trafic, envoyer des segments à X-Ray et afficher une carte de trace et de service.