Pilih preferensi cookie Anda

Kami menggunakan cookie penting serta alat serupa yang diperlukan untuk menyediakan situs dan layanan. Kami menggunakan cookie performa untuk mengumpulkan statistik anonim sehingga kami dapat memahami cara pelanggan menggunakan situs dan melakukan perbaikan. Cookie penting tidak dapat dinonaktifkan, tetapi Anda dapat mengklik “Kustom” atau “Tolak” untuk menolak cookie performa.

Jika Anda setuju, AWS dan pihak ketiga yang disetujui juga akan menggunakan cookie untuk menyediakan fitur situs yang berguna, mengingat preferensi Anda, dan menampilkan konten yang relevan, termasuk iklan yang relevan. Untuk menerima atau menolak semua cookie yang tidak penting, klik “Terima” atau “Tolak”. Untuk membuat pilihan yang lebih detail, klik “Kustomisasi”.

Menelusuri aplikasi dengan AWS X-Ray - AWS Bimbingan Preskriptif

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

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

Menelusuri aplikasi dengan AWS X-Ray

Permintaan melalui aplikasi Anda mungkin terdiri dari panggilan ke database, aplikasi, dan layanan web yang berjalan di server lokal, Amazon EC2, kontainer, atau Lambda. Dengan menerapkan penelusuran aplikasi, Anda dapat dengan cepat mengidentifikasi akar penyebab masalah dalam aplikasi Anda yang menggunakan komponen dan layanan terdistribusi. Anda dapat menggunakan AWS X-Rayuntuk melacak permintaan aplikasi Anda di beberapa komponen. X-Ray mengambil sampel dan memvisualisasikan permintaan pada grafik layanan ketika mereka mengalir melalui komponen aplikasi Anda dan setiap komponen direpresentasikan sebagai segmen. X-Ray menghasilkan pengidentifikasi jejak sehingga Anda dapat mengkorelasikan permintaan saat mengalir melalui beberapa komponen, yang membantu Anda melihat permintaan dari ujung ke ujung. Anda dapat lebih menyempurnakannya dengan menyertakan anotasi dan metadata untuk membantu mencari dan mengidentifikasi karakteristik permintaan secara unik.

Kami menyarankan Anda mengkonfigurasi dan instrumen setiap server atau titik akhir dalam aplikasi Anda dengan X-Ray. X-Ray diimplementasikan dalam kode aplikasi Anda dengan melakukan panggilan ke layanan X-Ray. X-Ray juga AWS SDKs menyediakan berbagai bahasa, termasuk klien instrumentasi yang secara otomatis mengirim data ke X-Ray. X-Ray SDKs menyediakan tambalan ke perpustakaan umum yang digunakan untuk melakukan panggilan ke layanan lain (misalnya, HTTP, MySQL, PostgreSQL, atau MongoDB).

X-Ray menyediakan daemon X-Ray yang dapat Anda instal dan jalankan di Amazon dan EC2 Amazon ECS untuk menyampaikan data ke X-Ray. X-Ray membuat jejak untuk aplikasi Anda yang menangkap data kinerja dari server dan kontainer yang menjalankan daemon X-Ray yang melayani permintaan. X-Ray secara otomatis menginstruksikan panggilan Anda ke AWS layanan, seperti Amazon DynamoDB, sebagai subsegmen melalui penambalan SDK. AWS X-Ray juga dapat secara otomatis terintegrasi dengan fungsi Lambda.

Jika komponen aplikasi Anda melakukan panggilan ke layanan eksternal yang tidak dapat mengonfigurasi dan menginstal daemon X-Ray atau instrumen kode, Anda dapat membuat subsegmen untuk membungkus panggilan ke layanan eksternal. X-Ray menghubungkan CloudWatch log dan metrik dengan jejak aplikasi Anda jika Anda menggunakan AWS X-Ray SDK for Java, yang berarti Anda dapat dengan cepat menganalisis metrik dan log terkait untuk permintaan.

Menyebarkan daemon X-Ray untuk melacak aplikasi dan layanan di Amazon EC2

Anda perlu menginstal dan menjalankan daemon X-Ray pada EC2 instance yang menjalankan komponen aplikasi atau layanan mikro Anda. Anda dapat menggunakan skrip data pengguna untuk menyebarkan daemon X-Ray saat EC2 instance disediakan atau Anda dapat menyertakannya dalam proses pembuatan AMI jika Anda membuat sendiri. AMIs Ini bisa sangat berguna ketika EC2 contoh bersifat fana.

Anda harus menggunakan State Manager untuk memastikan bahwa daemon X-Ray diinstal secara konsisten pada instans Anda EC2 . Untuk instans Amazon EC2 Windows, Anda dapat menggunakan Systems Manager AWS- RunPowerShellScript dokumen untuk menjalankan skrip Windows yang mengunduh dan menginstal agen X-Ray. Untuk EC2 contoh di Linux, Anda dapat menggunakan RunShellScript dokumen AWS- untuk menjalankan skrip Linux yang mengunduh dan menginstal agen sebagai layanan.

Anda dapat menggunakan Systems Manager AWS- RunRemoteScript dokumen untuk menjalankan skrip di lingkungan multi-akun. Anda harus membuat bucket S3 yang dapat diakses dari semua akun Anda dan sebaiknya buat bucket S3 dengan kebijakan bucket berbasis organisasi jika Anda menggunakannya. AWS Organizations Anda kemudian mengunggah skrip ke bucket S3 tetapi pastikan bahwa peran IAM untuk EC2 instans Anda memiliki izin untuk mengakses bucket dan skrip.

Anda juga dapat mengonfigurasi State Manager untuk mengaitkan skrip ke EC2 instance yang memiliki agen X-Ray diinstal. Karena semua EC2 instance Anda mungkin tidak memerlukan atau menggunakan X-Ray, Anda dapat menargetkan asosiasi dengan tag instance. Misalnya, Anda dapat membuat asosiasi Manajer Negara berdasarkan keberadaan InstallAWSXRayDaemonWindows atau InstallAWSXRayDaemonLinux tag.

Menyebarkan daemon X-Ray untuk melacak aplikasi dan layanan di Amazon ECS atau Amazon EKS

Anda dapat menggunakan daemon X-Ray sebagai wadah sespan untuk beban kerja berbasis kontainer seperti Amazon ECS atau Amazon EKS. Kontainer aplikasi Anda kemudian dapat terhubung ke wadah sespan Anda dengan penautan kontainer jika Anda menggunakan Amazon ECS, atau penampung dapat langsung terhubung ke wadah sespan di localhost jika Anda menggunakan mode jaringan awsvpc.

Untuk Amazon EKS, Anda dapat menentukan daemon X-Ray dalam definisi pod aplikasi Anda dan kemudian aplikasi Anda dapat terhubung ke daemon melalui localhost pada port container yang Anda tentukan.

Mengkonfigurasi Lambda untuk melacak permintaan ke X-Ray

Aplikasi Anda mungkin menyertakan panggilan ke fungsi Lambda. Anda tidak perlu menginstal daemon X-Ray untuk Lambda karena proses daemon sepenuhnya dikelola oleh Lambda dan tidak dapat dikonfigurasi oleh pengguna. Anda dapat mengaktifkannya untuk fungsi Lambda Anda dengan menggunakan AWS Management Console dan memeriksa opsi Active Tracing di konsol X-Ray.

Untuk instrumentasi lebih lanjut, Anda dapat menggabungkan X-Ray SDK dengan fungsi Lambda Anda untuk merekam panggilan keluar dan menambahkan anotasi atau metadata.

Menginstrumentasi aplikasi Anda untuk X-Ray

Anda harus mengevaluasi X-Ray SDK yang selaras dengan bahasa pemrograman aplikasi Anda dan mengklasifikasikan semua panggilan yang dilakukan aplikasi Anda ke sistem lain. Tinjau klien yang disediakan oleh pustaka yang Anda pilih dan lihat apakah SDK dapat secara otomatis melacak instrumen untuk permintaan atau respons aplikasi Anda. Tentukan apakah klien yang disediakan oleh SDK dapat digunakan untuk sistem hilir lainnya. Untuk sistem eksternal yang dipanggil aplikasi Anda dan yang tidak dapat Anda instrumen dengan X-Ray, Anda harus membuat subsegmen khusus untuk menangkap dan mengidentifikasi mereka dalam informasi jejak Anda.

Saat Anda menginstruksikan aplikasi Anda, pastikan Anda membuat anotasi untuk membantu Anda mengidentifikasi dan mencari permintaan. Misalnya, aplikasi Anda mungkin menggunakan pengenal untuk pelanggan, seperticustomer id, atau mengelompokkan pengguna yang berbeda berdasarkan peran mereka dalam aplikasi.

Anda dapat membuat maksimal 50 anotasi untuk setiap jejak tetapi Anda dapat membuat objek metadata yang berisi satu atau beberapa bidang selama dokumen segmen tidak melebihi 64 kilobyte. Anda harus secara selektif menggunakan anotasi untuk menemukan informasi dan menggunakan objek metadata untuk menyediakan lebih banyak konteks yang membantu memecahkan masalah permintaan setelah ditemukan.

Mengkonfigurasi aturan pengambilan sampel X-Ray

Dengan menyesuaikan aturan pengambilan sampel, Anda dapat mengontrol jumlah data yang Anda rekam dan memodifikasi perilaku pengambilan sampel tanpa memodifikasi atau menerapkan ulang kode Anda. Aturan pengambilan sampel memberi tahu SDK X-Ray jumlah permintaan yang harus dicatat untuk satu set kriteria. Secara default, X-Ray SDK merekam permintaan pertama setiap detik dan lima persen dari setiap permintaan tambahan. Satu permintaan per detik adalah reservoir. Tindakan ini memastikan bahwa setidaknya satu pelacakan dicatat setiap detik selama layanan melayani permintaan. Lima persen adalah tingkat di mana permintaan tambahan diambil sampelnya di luar ukuran reservoir.

Anda harus meninjau dan memperbarui konfigurasi default untuk menentukan nilai yang sesuai untuk akun Anda. Persyaratan Anda mungkin berbeda dalam pengembangan, pengujian, uji kinerja, dan lingkungan produksi. Anda mungkin memiliki aplikasi yang memerlukan aturan pengambilan sampel mereka sendiri berdasarkan jumlah lalu lintas yang mereka terima atau tingkat kekritisan mereka. Anda harus mulai dengan garis dasar dan secara teratur mengevaluasi kembali apakah baseline memenuhi persyaratan Anda.

PrivasiSyarat situsPreferensi cookie
© 2025, Amazon Web Services, Inc. atau afiliasinya. Semua hak dilindungi undang-undang.