Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Gunakan SDK
catatan
X-Ray SDK/Daemon Pemberitahuan Pemeliharaan - Pada tanggal 25 Februari 2026, AWS X-Ray SDKs/Daemon akan memasuki mode pemeliharaan, di mana AWS akan membatasi rilis X-Ray SDK dan Daemon untuk mengatasi masalah keamanan saja. Untuk informasi selengkapnya tentang garis waktu dukungan, lihatGaris waktu Dukungan X-Ray SDK dan Daemon. Kami merekomendasikan untuk bermigrasi ke OpenTelemetry. Untuk informasi selengkapnya tentang migrasi ke OpenTelemetry, lihat Migrasi dari X-Ray instrumentasi ke instrumentasi. OpenTelemetry
Gunakan SDK jika Anda ingin menggunakan antarmuka baris perintah atau memerlukan lebih banyak kemampuan pelacakan, pemantauan, atau pencatatan khusus daripada yang tersedia di Konsol Manajemen AWS. Anda juga dapat menggunakan AWS SDK untuk mengembangkan program yang menggunakan X-Ray API. Anda dapat menggunakan AWS Distro for OpenTelemetry (ADOT) SDK atau SDK. X-Ray
Jika Anda menggunakan SDK, Anda dapat menambahkan penyesuaian ke alur kerja Anda baik saat instrumen aplikasi maupun saat mengonfigurasi kolektor atau agen Anda. Anda dapat menggunakan SDK untuk melakukan tugas-tugas berikut yang tidak dapat Anda lakukan menggunakan Konsol Manajemen AWS:
-
Publikasikan metrik kustom — Contoh metrik pada resolusi tinggi hingga 1 detik, gunakan beberapa dimensi untuk menambahkan informasi tentang metrik, dan agregasikan titik data ke dalam kumpulan statistik.
-
Sesuaikan kolektor Anda - Sesuaikan konfigurasi untuk bagian mana pun dari kolektor termasuk penerima, prosesor, eksportir, dan konektor.
-
Sesuaikan instrumentasi Anda — Kustomisasi segmen dan subsegmen, tambahkan pasangan kunci-nilai kustom 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 AWS keamanan dan pengoptimalan tambahan. AWS Distro for OpenTelemetry (ADOT) SDK adalah paket vendor-agnostik yang memungkinkan integrasi dengan back end dari vendor lain dan non-AWS layanan tanpa harus mengkonfigurasi ulang kode Anda.
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 sekumpulan API open source, pustaka, dan agen yang mengirim data ke layanan backend. ADOTdidukung oleh AWS, terintegrasi dengan beberapa backend dan agen, dan menyediakan sejumlah besar perpustakaan open source yang dikelola oleh OpenTelemetry komunitas. Gunakan ADOT SDK untuk instrumen aplikasi Anda dan mengumpulkan log, metadata, metrik, dan jejak. Anda juga dapat menggunakannya ADOT untuk memantau layanan dan mengatur alarm berdasarkan metrik Anda di CloudWatch.
Jika Anda menggunakan ADOT SDK, Anda memiliki opsi berikut, dalam kombinasi dengan agen:
-
Gunakan ADOT SDK dengan CloudWatch agen — disarankan.
-
Gunakan ADOT SDK dengan Kolek ADOT tor
— disarankan jika Anda ingin menggunakan perangkat lunak agnostik vendor dengan AWS lapisan keamanan dan pengoptimalan.
Untuk menggunakan ADOT SDK, lakukan hal berikut:
-
Instrumentasikan 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 dikumpulkan.
Setelah ADOT kolektor menerima data Anda, ia mengirimkannya ke backend yang Anda tentukan dalam ADOT konfigurasi. ADOTdapat mengirim data ke beberapa backend, termasuk ke vendor di luar AWS, seperti yang ditunjukkan dalam diagram berikut:
AWS secara teratur memperbarui ADOT untuk menambahkan fungsionalitas dan menyelaraskan dengan OpenTelemetry
-
Go
-
Java
-
JavaScript
-
Python
-
.NET
-
Ruby
-
PHP
Jika Anda menggunakan Python, ADOT dapat secara otomatis instrumen aplikasi Anda. Untuk mulai menggunakanADOT, lihat Pendahuluan
Gunakan X-Ray SDK
X-Ray SDK adalah sekumpulan AWS API 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 kompatibel dengan X-Ray SDK.
Untuk menggunakan X-Ray SDK, lakukan hal berikut:
-
Instrumentasikan aplikasi Anda menggunakan X-Ray SDK.
-
Konfigurasikan kolektor untuk memberi tahu ke mana harus mengirim data yang dikumpulkan. Anda dapat menggunakan CloudWatch agen atau X-Ray daemon untuk mengumpulkan informasi pelacakan 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 instrumen aplikasi Anda secara otomatis. Untuk mulai menggunakan X-Ray SDK, lihat pustaka yang terkait dengan bahasa pemrograman berikut:
