View a markdown version of this page

AWS X-Ray exemple d'application - 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.

AWS X-Ray exemple d'application

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.

L'exemple d'application AWS X-Ray eb-java-scorekeep, disponible sur GitHub, montre l'utilisation du SDK pour contrôler les appels HTTP entrants, les clients du AWS X-Ray SDK DynamoDB et les clients HTTP. L'exemple d'application permet CloudFormation de créer des tables DynamoDB, de compiler du code Java sur une instance et d'exécuter le X-Ray démon sans aucune configuration supplémentaire.

Consultez le didacticiel Scorekeep pour commencer à installer et à utiliser un exemple d'application instrumenté, en utilisant le ou le Console de gestion AWS . AWS CLI

Scorekeep utilise le AWS X-Ray SDK pour instrumenter les appels HTTP entrants, les clients du SDK DynamoDB et les clients HTTP

L'exemple inclut une application Web frontale, l'API qu'elle appelle et les tables DynamoDB qu'elle utilise pour stocker des données. L'instrumentation de base avec des filtres , des plugins et des clients AWS SDK instrumentés est présentée dans la branche du xray-gettingstarted projet. Il s'agit de la branche que vous déployez dans le didacticiel de mise en route. Dans la mesure où cette branche inclut uniquement les éléments de base, vous pouvez la comparer à la branche master pour comprendre rapidement les éléments de base.

Carte de service montrant le client se connectant au conteneur Scorekeep, qui se connecte aux DynamoDB tables et au SNS.

L'exemple d'application montre l'instrumentation de base dans ces fichiers :

La xray branche de l'application inclut l'utilisation de HttpClient, d'annotations, de requêtes SQL, de sous-segments Génération de sous-segments personnalisés avec le X-Ray SDK for Java personnalisés, d'une AWS Lambda fonction instrumentée ainsi que de code et de scripts d'initialisation instrumentés.

Pour faciliter la connexion des utilisateurs et leur AWS SDK pour JavaScript utilisation dans le navigateur, la xray-cognito branche ajoute Amazon Cognito pour permettre l'authentification et l'autorisation des utilisateurs. Grâce aux informations d'identification extraites d'Amazon Cognito, l'application Web envoie également des données de trace X-Ray pour enregistrer les informations relatives aux demandes du point de vue du client. Le client du navigateur apparaît comme son propre nœud sur la carte de trace et enregistre des informations supplémentaires, notamment l'URL de la page que l'utilisateur est en train de consulter et son identifiant.

Enfin, la xray-worker branche ajoute une fonction Python Lambda instrumentée qui s'exécute indépendamment et traite les éléments d'une file d'attente Amazon SQS. Scorekeep ajoute un élément à la file d'attente chaque fois qu'un jeu se termine. Le worker Lambda, déclenché par CloudWatch des événements, extrait des éléments de la file d'attente toutes les quelques minutes et les traite pour stocker les enregistrements de jeu dans Amazon S3 à des fins d'analyse.

Rubriques