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

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

  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 SDKsAPIs, 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 plus d’informations, consultez 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 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 IAM politique et déployer un agent ou un collecteur.

    • Pour des exemples de scripts permettant de déployer une application à l'aide de AWS Distro for OpenTelemetry (ADOT) SDK 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 démon X-Ray SDK et du daemon X-Ray, consultezAWS X-Ray exemple d'application.

  4. (Facultatif) Ouvrez une console pour afficher et analyser les données. Vous pouvez voir une GUI représentation 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 HTTP réponse.

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.