View a markdown version of this page

Memulai dengan X-Ray - AWS X-Ray

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memulai dengan X-Ray

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

Untuk menggunakan X-Ray, lakukan langkah-langkah berikut:

  1. Instrumentasikan aplikasi Anda, yang memungkinkan X-Ray untuk melacak bagaimana aplikasi Anda memproses permintaan.

    • Gunakan X-Ray SDK, X-Ray API, ADOT atau Sinyal CloudWatch Aplikasi untuk mengirim data pelacakan ke X-Ray. Untuk informasi selengkapnya tentang antarmuka mana yang akan digunakan, lihatMemilih antarmuka.

    Untuk informasi lebih lanjut tentang instrumentasi, lihatInstrumentasi aplikasi Anda untuk AWS X-Ray.

  2. (Opsional) Konfigurasikan X-Ray untuk bekerja dengan Layanan AWS yang lain yang terintegrasi dengan X-Ray. Anda dapat mengambil sampel jejak dan menambahkan header ke permintaan masuk, menjalankan agen atau kolektor, dan secara otomatis mengirim data pelacakan ke X-Ray. Untuk informasi selengkapnya, lihat Integrasi AWS X-Ray dengan yang lain Layanan AWS.

  3. Terapkan aplikasi berinstrumen Anda. Saat aplikasi Anda menerima permintaan, X-Ray SDK akan merekam data jejak, segmen, dan subsegmen. Pada langkah ini, Anda mungkin juga harus menyiapkan kebijakan IAM dan menyebarkan agen atau kolektor.

    • Misalnya skrip untuk menerapkan aplikasi menggunakan AWS Distro for OpenTelemetry (ADOT) SDK dan CloudWatch agen pada platform yang berbeda, lihat Skrip Demo Sin yal Aplikasi.

    • Untuk contoh skrip untuk menerapkan aplikasi menggunakan X-Ray SDK dan X-Ray daemon, lihatAWS X-Ray contoh aplikasi.

  4. (Opsional) Buka konsol untuk melihat dan menganalisis data. Anda dapat melihat representasi GUI dari peta jejak, peta layanan, dan lainnya untuk memeriksa bagaimana fungsi aplikasi Anda. Gunakan informasi grafis di konsol untuk mengoptimalkan, men-debug, dan memahami aplikasi Anda. Untuk informasi selengkapnya tentang memilih konsol, lihatGunakan konsol.

Diagram berikut menunjukkan cara memulai menggunakan X-Ray:

X-Ray menampilkan informasi terperinci tentang permintaan aplikasi termasuk status, durasi dan kode respons HTTP.

Untuk contoh data dan peta yang tersedia di konsol, luncurkan aplikasi sampel yang sudah diinstrumentasi untuk menghasilkan data jejak. Dalam beberapa menit, Anda dapat menghasilkan lalu lintas, mengirim segmen ke X-Ray, dan melihat peta jejak dan layanan.