Instrumentación AWS manual de los clientes del SDK - 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.

Instrumentación AWS manual de los clientes del SDK

nota

Aviso de SDK/Daemon mantenimiento de X-Ray: el 25 de febrero de 2026, el AWS X-Ray SDKs/Daemon entrará en modo de mantenimiento, donde AWS se limitarán las versiones de X-Ray SDK y Daemon para abordar únicamente los problemas de seguridad. 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 instrumentación de rayos X a una instrumentación. OpenTelemetry

El X-Ray SDK para Java instrumenta automáticamente todos los clientes del AWS SDK al incluir el submódulo AWS SDK Instrumentor en las dependencias de compilación.

Puede deshabilitar la instrumentación de clientes automática eliminando el submódulo Instrumentor. Esto le permite instrumentar algunos clientes manualmente a la vez que se pasan otros por alto, o utilizar diferentes controladores de rastreo en clientes distintos.

Para ilustrar la compatibilidad con la instrumentación de clientes de AWS SDK específicos, la aplicación pasa un controlador de rastreo AmazonDynamoDBClientBuilder como controlador de solicitudes en el modelo de usuario, juego y sesión. Esta modificación del código indica al SDK que instrumente todas las llamadas a DynamoDB con esos clientes.

ejemplo src/main/java/scorekeep/SessionModel.java:instrumentación manual de clientes del SDK de AWS
import com.amazonaws.xray.AWSXRay;
import com.amazonaws.xray.handlers.TracingHandler;

public class SessionModel {
  private AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard()
        .withRegion(Constants.REGION)
        .withRequestHandlers(new TracingHandler(AWSXRay.getGlobalRecorder()))
        .build();
  private DynamoDBMapper mapper = new DynamoDBMapper(client);

Si eliminas el submódulo AWS SDK Instrumentor de las dependencias del proyecto, solo los clientes del SDK AWS instrumentados manualmente aparecen en el mapa de seguimiento.