Menginstrumentasi klien AWS SDK secara manual

catatan

End-of-support pemberitahuan — Pada tanggal 25 Februari 2027, AWS X-Ray akan menghentikan dukungan untuk AWS X-Ray SDKs dan daemon. Setelah 25 Februari 2027, Anda tidak akan lagi menerima pembaruan atau rilis. Untuk informasi selengkapnya tentang garis waktu dukungan, lihatX-Ray SDK dan daemon akhir garis waktu dukungan. Kami merekomendasikan untuk bermigrasi ke OpenTelemetry. Untuk informasi lebih lanjut tentang migrasi ke OpenTelemetry, lihat Migrasi dari instrumentasi X-Ray ke instrumentasi. OpenTelemetry

X-Ray SDK for Java secara otomatis menginstrumentasikan AWS semua klien SDK saat Anda menyertakan submodul SDK Instrumentor AWS dalam dependensi build Anda.

Anda dapat menonaktifkan instrumentasi klien otomatis dengan menghapus submodul Instrumentor. Hal ini memungkinkan Anda untuk menginstruksikan beberapa klien secara manual sambil mengabaikan yang lain, atau menggunakan pengendali pelacakan yang berbeda pada klien yang berbeda.

Untuk mengilustrasikan dukungan untuk menginstrumentasi klien AWS SDK tertentu, aplikasi meneruskan penangan penelusuran AmazonDynamoDBClientBuilder sebagai penangan permintaan dalam model pengguna, game, dan sesi. Perubahan kode ini memberi tahu SDK untuk memasukkan semua panggilan ke DynamoDB menggunakan klien tersebut.

contoh src/main/java/scorekeep/SessionModel.java – Instrumentasi klien AWS SDK manual

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);

Jika Anda menghapus submodul AWS SDK Instrumentor dari dependensi proyek, hanya klien AWS SDK yang diinstrumentasi secara manual yang muncul di peta jejak.