Menggunakan SDK

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

Gunakan SDK jika Anda ingin menggunakan antarmuka baris perintah atau memerlukan lebih banyak kemampuan penelusuran, pemantauan, atau pencatatan kustom daripada yang tersedia di file. AWS Management Console Anda juga dapat menggunakan AWS SDK untuk mengembangkan program yang menggunakan APIs X-Ray. Anda dapat menggunakan AWS Distro for OpenTelemetry (ADOT) SDK atau X-Ray SDK.

Jika Anda menggunakan SDK, Anda dapat menambahkan kustomisasi ke alur kerja Anda baik ketika Anda instrumen aplikasi Anda dan ketika Anda mengkonfigurasi kolektor atau agen Anda. Anda dapat menggunakan SDK untuk melakukan tugas-tugas berikut yang tidak dapat Anda lakukan dengan menggunakan: AWS Management Console

• Publikasikan metrik khusus — Contoh metrik pada resolusi tinggi hingga 1 detik, gunakan beberapa dimensi untuk menambahkan informasi tentang metrik, dan agregat titik data ke dalam kumpulan statistik.

• Sesuaikan kolektor Anda - Sesuaikan konfigurasi untuk setiap bagian dari kolektor termasuk penerima, prosesor, eksportir, dan konektor.

• Sesuaikan instrumentasi Anda — Sesuaikan segmen dan subsegmen, tambahkan pasangan nilai kunci khusus sebagai atribut, dan buat metrik khusus.

• Buat dan perbarui aturan pengambilan sampel secara terprogram.

Gunakan ADOT SDK jika Anda menginginkan fleksibilitas menggunakan OpenTelemetry SDK standar dengan lapisan keamanan dan pengoptimalan tambahan. AWS AWS Distro for OpenTelemetry (ADOT) SDK adalah paket vendor-agnostik yang memungkinkan integrasi dengan back end dari vendor lain dan non-layanan tanpa harus menginstrumentasi ulang kode Anda.AWS

Gunakan X-Ray SDK jika Anda sudah menggunakan X-Ray SDK, hanya mengintegrasikan dengan AWS backend, dan tidak ingin mengubah cara Anda berinteraksi dengan X-Ray atau kode aplikasi Anda.

Untuk informasi selengkapnya tentang setiap fitur, lihatMemilih antara AWS Distro untuk OpenTelemetry dan X-Ray SDKs.

Gunakan ADOT SDK

ADOTSDK adalah seperangkat open source APIs, perpustakaan, dan agen yang mengirim data ke layanan backend. ADOTdidukung oleh AWS, terintegrasi dengan beberapa backend dan agen, dan menyediakan sejumlah besar pustaka open source yang dikelola oleh komunitas. OpenTelemetry Gunakan ADOT SDK untuk menginstrumentasikan aplikasi Anda dan mengumpulkan log, metadata, metrik, dan jejak. Anda juga dapat menggunakan ADOT untuk memantau layanan dan mengatur alarm berdasarkan metrik Anda. CloudWatch

Jika Anda menggunakan ADOT SDK, Anda memiliki opsi berikut, dalam kombinasi dengan agen:

• Gunakan ADOT SDK dengan CloudWatch agen — direkomendasikan.

• Gunakan ADOT SDK dengan ADOTKolektor — disarankan jika Anda ingin menggunakan perangkat lunak agnostik vendor dengan AWS lapisan keamanan dan pengoptimalan.

Untuk menggunakan ADOT SDK, lakukan hal berikut:

• Instrument aplikasi Anda menggunakan ADOT SDK. Untuk informasi selengkapnya, lihat dokumentasi untuk bahasa pemrograman Anda di dokumentasi teknis ADOT.

• Konfigurasikan ADOT kolektor untuk memberi tahu ke mana harus mengirim data yang dikumpulkannya.

Setelah ADOT kolektor menerima data Anda, ia mengirimkannya ke backend yang Anda tentukan dalam konfigurasi. ADOT ADOTdapat mengirim data ke beberapa backend, termasuk ke vendor di luar AWS, seperti yang ditunjukkan pada diagram berikut:

AWS memperbarui secara teratur ADOT untuk menambahkan fungsionalitas dan menyelaraskan dengan OpenTelemetrykerangka kerja. Pembaruan dan rencana pengembangan masa depan ADOT adalah bagian dari peta jalan yang tersedia untuk umum. ADOTmendukung beberapa bahasa pemrograman yang meliputi:

• Go

• Java

• JavaScript

• Python

• .NET

• Ruby

• PHP

Jika Anda menggunakan Python, secara otomatis ADOT dapat instrumen aplikasi Anda. Untuk mulai menggunakanADOT, lihat Pendahuluan dan Memulai dengan AWS Distro untuk OpenTelemetry Kolektor.

Gunakan X-Ray SDK

X-Ray SDK adalah sekumpulan AWS APIs dan pustaka yang mengirim data ke layanan AWS backend. Gunakan X-Ray SDK untuk instrumen aplikasi Anda dan mengumpulkan data jejak. Anda tidak dapat menggunakan X-Ray SDK untuk mengumpulkan data log atau metrik.

Jika Anda menggunakan X-Ray SDK, Anda memiliki opsi berikut, dalam kombinasi dengan agen:

• Gunakan X-Ray SDK dengan AWS X-Ray daemon — Gunakan ini jika Anda tidak ingin memperbarui kode aplikasi Anda.

• Gunakan X-Ray SDK dengan CloudWatch agen — (disarankan) CloudWatch Agen ini kompatibel dengan X-Ray SDK.

Untuk menggunakan X-Ray SDK, lakukan hal berikut:

• Instrumen aplikasi Anda menggunakan X-Ray SDK.

• Konfigurasikan kolektor untuk memberi tahu ke mana harus mengirim data yang dikumpulkannya. Anda dapat menggunakan CloudWatch agen atau daemon X-Ray untuk mengumpulkan informasi jejak Anda.

Setelah kolektor atau agen menerima data Anda, ia mengirimkannya ke AWS backend yang Anda tentukan dalam konfigurasi agen. X-Ray SDK hanya dapat mengirim data ke AWS backend seperti yang ditunjukkan pada diagram berikut:

Jika Anda menggunakanJava, Anda dapat menggunakan X-Ray SDK untuk secara otomatis instrumen aplikasi Anda. Untuk mulai menggunakan X-Ray SDK, lihat pustaka yang terkait dengan bahasa pemrograman berikut:

• Go

• Java

• Node.js

• Python

• .NET

• Ruby