Strumentazione manuale dei client SDK AWS - AWS X-Ray

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Strumentazione manuale dei client SDK AWS

Nota

Avviso di SDK/Daemon manutenzione a raggi X: il 25 febbraio 2026, X-Ray SDKs/Daemon entrerà in modalità di manutenzione, in cui AWS limiterà le versioni di AWS X-Ray SDK e Daemon per risolvere solo problemi di sicurezza. Per ulteriori informazioni sulla tempistica del supporto, consulta. Cronologia di X-Ray SDK e Daemon Support Ti consigliamo di migrare a. OpenTelemetry Per ulteriori informazioni sulla migrazione a OpenTelemetry, vedere Migrazione dalla strumentazione a raggi X alla strumentazione. OpenTelemetry

L'X-Ray SDK for Java strumenta automaticamente tutti i client SDK quando includi il AWS sottomodulo SDK Instrumentor nelle AWS dipendenze di compilazione.

Puoi disabilitare l'analisi automatica del client rimuovendo il sottomodulo Instrumentor. In questo modo puoi analizzare manualmente alcuni client escludendone altri, oppure utilizzare diversi gestori del tracciamento su diversi client.

Per illustrare il supporto per la strumentazione di client AWS SDK specifici, l'applicazione passa un gestore di tracciamento come gestore di richieste nel modello utente, di gioco e di AmazonDynamoDBClientBuilder sessione. Questa modifica al codice indica all'SDK di strumentare tutte le chiamate a DynamoDB utilizzando tali client.

Esempio src/main/java/scorekeep/SessionModel.java— Strumentazione manuale del client SDK 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);

Se rimuovi il sottomodulo AWS SDK Instrumentor dalle dipendenze del progetto, nella mappa di traccia vengono visualizzati solo i client SDK con strumentazione AWS manuale.