Mengonfigurasi debugging AWS X-Ray

Anda dapat menggunakan konsol AWS Elastic Beanstalk atau file konfigurasi untuk menjalankan daemon AWS X-Ray pada instans di lingkungan Anda. X-Ray adalah layanan AWS yang mengumpulkan data tentang permintaan yang dilayani aplikasi Anda, dan menggunakannya untuk membuat peta layanan yang dapat Anda gunakan untuk mengidentifikasi masalah dengan aplikasi Anda dan peluang untuk pengoptimalan.

catatan

Beberapa wilayah tidak menawarkan X-Ray. Jika Anda membuat lingkungan di salah satu wilayah ini, Anda tidak dapat menjalankan daemon X-Ray pada instans di lingkungan Anda.

Untuk informasi tentang layanan AWS yang ditawarkan pada masing-masing Wilayah, lihat Tabel Wilayah.

X-Ray menyediakan SDK yang dapat Anda gunakan untuk melengkapi kode aplikasi Anda, dan aplikasi daemon yang menyampaikan informasi debugging dari SDK ke API X-Ray.

Platform yang didukung

Anda dapat menggunakan SDK X-Ray dengan platform Elastic Beanstalk berikut ini:

• Pergi - versi 2.9.1 dan yang lebih baru

• Java 8 - versi 2.3.0 dan yang lebih baru

• Java 8 dengan Tomcat 8 - versi 2.4.0 dan yang lebih baru

• Node.js - versi 3.2.0 dan yang lebih baru

• Server Windows - semua versi platform yang dirilis pada atau setelah 18 Desember 2016

• Python - versi 2.5.0 dan yang lebih baru

Pada platform yang didukung, Anda dapat menggunakan opsi konfigurasi untuk menjalankan daemon X-Ray pada instans di lingkungan Anda. Anda dapat mengaktifkan daemon di konsol Elastic Beanstalk atau dengan menggunakan file konfigurasi.

Untuk mengunggah data ke X-Ray, daemon X-Ray memerlukan izin IAM dalam kebijakan yang dikelola. AWSXrayWriteOnlyAccess Izin ini disertakan dalam profil instans Elastic Beanstalk. Jika Anda tidak menggunakan profil instans default, lihat Memberikan Izin Daemon untuk Mengirim Data ke X-Ray di AWS X-Ray Panduan Developer.

Debugging dengan X-Ray memerlukan penggunaan X-Ray SDK. Lihat Memulai dengan AWS X-Ray di Panduan Developer AWS X-Ray untuk instruksi dan aplikasi sampel.

Jika Anda menggunakan versi platform yang tidak menyertakan daemon, Anda masih dapat menjalankannya dengan skrip di file konfigurasi. Untuk informasi selengkapnya, lihat Mengunduh dan Menjalankan Daemon X-Ray (Lanjutan) di Panduan Developer AWS X-Ray.

Mengonfigurasi debugging

Anda dapat mengaktifkan daemon X-Ray pada lingkungan yang berjalan di konsol Elastic Beanstalk.

Untuk mengaktifkan debugging di konsol Elastic Beanstalk

1. Buka konsol Elastic Beanstalk, dan dalam daftar Regions, pilih Anda. Wilayah AWS

2. Di panel navigasi, pilih Lingkungan, dan kemudian pilih nama lingkungan Anda dari daftar.

   catatan

   Jika Anda memiliki banyak lingkungan, gunakan bilah pencarian untuk memfilter daftar lingkungan.

3. Di panel navigasi, pilih Konfigurasi.

4. Dalam kategori Pembaruan, pemantauan, dan konfigurasi logging, pilih Edit.

5. Di bagian Amazon X-Ray, pilih Diaktifkan.

6. Untuk menyimpan perubahan pilih Terapkan di bagian bawah halaman.

Anda juga dapat mengaktifkan opsi ini selama pembuatan lingkungan. Untuk informasi selengkapnya, lihat Wizard pembuatan lingkungan baru.

Namespace aws:elasticbeanstalk:xray

Anda dapat menggunakan opsi XRayEnabled pada namespace aws:elasticbeanstalk:xray untuk mengaktifkan debugging.

Untuk mengaktifkan debugging secara otomatis ketika Anda menerapkan aplikasi Anda, atur opsi dalam file konfigurasi pada kode sumber Anda, sebagai berikut.

contoh .ebextensions/debugging.config

option_settings:
  aws:elasticbeanstalk:xray:
    XRayEnabled: true