Commencer à utiliser 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 à utiliser X-Ray

Note

End-of-support avis — Le 25 février 2027, AWS X-Ray cessera de prendre en charge AWS X-Ray SDKs et Daemon. Après le 25 février 2027, vous ne recevrez plus de mises à jour ni de versions. Pour plus d'informations sur le calendrier de support, consultezChronologie de fin de support du SDK et du daemon X-Ray. Nous vous recommandons de migrer vers OpenTelemetry. Pour plus d'informations sur la migration vers OpenTelemetry, consultez la section Migration de l'instrumentation X-Ray vers OpenTelemetry l'instrumentation.

Pour utiliser X-Ray, suivez les étapes suivantes :

  1. Instrumentez votre application, ce qui permet à X-Ray de suivre la manière dont votre application traite une demande.

    • Utilisez les signaux X-Ray SDKs APIs, X-Ray ADOT ou CloudWatch 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, voirInstrumentation de votre application pour AWS X-Ray.

  2. (Facultatif) Configurez X-Ray pour Services AWS qu'il fonctionne avec d'autres appareils intégrés à 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 les données de trace à X-Ray. Pour de plus amples informations, veuillez consulter Intégration AWS X-Ray avec d'autres Services AWS.

  3. Déployez votre application instrumentée. Au fur et à mesure que votre application reçoit des demandes, le SDK X-Ray 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 des signaux d'application.

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

  4. (Facultatif) Ouvrez une console pour afficher et analyser les données. Vous pouvez consulter 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 d'applications, 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 suivi. En quelques minutes, vous pouvez générer du trafic, envoyer des segments à X-Ray et consulter une trace et une carte des services.