View a markdown version of this page

AWS X-Ray aplicación de muestra - AWS X-Ray

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWS X-Ray aplicación de muestra

nota

X-Ray SDK/Daemon Aviso de mantenimiento: el 25 de febrero de 2026, AWS X-Ray SDKs/Daemon entrará en modo de mantenimiento, donde AWS se limitarán las versiones de X-Ray SDK y Daemon a problemas de seguridad únicamente. Para obtener más información sobre la cronología del soporte, consulte Cronología de X-Ray SDK y Daemon Support. Recomendamos migrar a. OpenTelemetry Para obtener más información sobre la migración a OpenTelemetry, consulte Migración de una X-Ray instrumentación a otra. OpenTelemetry

La aplicación de ejemplo AWS X-Ray eb-java-scorekeep, disponible en, muestra el uso del SDK para instrumentar las llamadas HTTP entrantes GitHub, los clientes del AWS X-Ray SDK de DynamoDB y los clientes HTTP. La aplicación de ejemplo se utiliza CloudFormation para crear tablas de DynamoDB, compilar código Java en una instancia y ejecutar el daemon sin ninguna configuración adicional. X-Ray

Consulte el tutorial de Scorekeep para empezar a instalar y utilizar una aplicación de ejemplo instrumentada, utilizando o la. Consola de administración de AWS AWS CLI

Scorekeep usa el AWS X-Ray SDK para instrumentar las llamadas HTTP entrantes, los clientes del SDK de DynamoDB y los clientes HTTP

La muestra incluye una aplicación web frontend, la API a la que llama y las tablas de DynamoDB que usa para almacenar los datos. La instrumentación básica con filtros, complementos y clientes de AWS SDK instrumentados se muestra en la rama del proyecto. xray-gettingstarted Esta es la ramificación que se implementa en el tutorial Introducción. Dado que esta ramificación solo incluye los aspectos básicos, puede diferenciarla rápidamente de la ramificación master para comprender rápidamente los aspectos básicos.

El mapa de servicio muestra al cliente conectándose al contenedor Scorekeep, que se conecta a las tablas y al SNS. DynamoDB

La aplicación de ejemplo muestra una instrumentación básica en estos archivos:

La ramificación xray de la aplicación incluye el uso de HTTPClient, Anotaciones, consultas SQL, subsegmentos personalizados, una función de AWS Lambda instrumentada, así como scripts y código de inicialización instrumentado.

Para permitir el inicio de sesión y el AWS SDK para JavaScript uso de los usuarios en el navegador, la xray-cognito sucursal añade Amazon Cognito para permitir la autenticación y la autorización de los usuarios. Con las credenciales recuperadas de Amazon Cognito, la aplicación web también envía datos de rastreo X-Ray para registrar la información de la solicitud desde el punto de vista del cliente. El cliente del navegador aparece como su propio nodo en el mapa de rastros y registra información adicional, incluida la URL de la página que el usuario está visualizando y el ID de usuario.

Por último, la ramificación xray-worker añade una función de Lambda en Python instrumentada que se ejecuta de forma independiente, procesando los elementos de una cola de Amazon SQS. Scorekeep añade un elemento a la cola cada vez que termina un juego. El programa de trabajo de Lambda, activado por CloudWatch eventos, extrae los elementos de la cola cada pocos minutos y los procesa para almacenar los registros de las partidas en Amazon S3 para su análisis.