Instrumentation manuelle des clients du AWS SDK

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.

Le SDK X-Ray pour Java instrumente automatiquement AWS tous les clients du SDK lorsque vous incluez AWS le sous-module SDK Instrumentor dans vos dépendances de build.

Vous pouvez désactiver l'instrumentation automatique du client en supprimant le sous-module Instrumentor. Ainsi, vous pourrez instrumenter certains clients manuellement tout en ignorant les autres, ou utiliser différents gestionnaires de suivi sur différents clients.

Pour illustrer la prise en charge de l'instrumentation de clients AWS SDK spécifiques, l'application transmet un gestionnaire de suivi en AmazonDynamoDBClientBuilder tant que gestionnaire de demandes dans le modèle utilisateur, jeu et session. Cette modification de code indique au SDK d'instrumenter tous les appels à DynamoDB à l'aide de ces clients.

Exemple src/main/java/scorekeep/SessionModel.java— Instrumentation client manuelle du AWS SDK

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 vous supprimez le sous-module AWS SDK Instrumentor des dépendances du projet, seuls les clients du AWS SDK instrumentés manuellement apparaissent dans la carte de trace.