Apa itu AWS X-Ray? - AWS X-Ray
Bagaimana X-Ray bekerjaKonsep

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

Apa itu AWS X-Ray?

AWS X-Ray menyediakan informasi jejak tentang setiap tanggapan dan panggilan yang diterima yang dibuat oleh aplikasi yang diinstrumentasi, termasuk hal-hal berikut:

  • Sumber daya hilir AWS

  • Layanan mikro

  • Basis Data

  • API Web

Gunakan data jejak dan visualisasi untuk mendapatkan wawasan tentang kinerja aplikasi Anda, mengidentifikasi masalah, dan menemukan peluang untuk pengoptimalan. Gunakan alat analisis dalam X-Ray untuk melihat, memfilter, dan menyelidiki detail untuk setiap permintaan yang dilacak ke aplikasi Anda.

Bagaimana X-Ray bekerja

Untuk menggunakan X-Ray, Anda harus terlebih dahulu instrumen aplikasi Anda sehingga X-Ray dapat melacak bagaimana aplikasi Anda menangani permintaan. Menambahkan instrumentasi ke aplikasi Anda memungkinkan X-Ray mengirim data jejak dan metadata untuk permintaan masuk dan keluar dan peristiwa lain dalam aplikasi Anda. Misalnya, Anda dapat menginstruksikan semua permintaan HTTP masuk dan panggilan hilir ke Layanan AWS aplikasi Java Anda. Anda juga dapat menginstruksikan aplikasi Anda secara otomatis. Untuk informasi selengkapnya, lihat Menginstrumentasi aplikasi Anda untuk informasi selengkapnya.

X-Ray memberikan trace id untuk setiap permintaan yang diterima aplikasi instrumentasi Anda. Jika aplikasi Anda berinteraksi dengan komponen lain, X-Ray membuat segmen. Segmen ini dikaitkan dengan id jejak asli dan melacak kualitas interaksi dengan komponen tersebut.

X-Ray melacak trace id dan segmen di seluruh alur kerja aplikasi Anda. Anda dapat menganalisis seluruh alur kerja atau mengisolasi bagian untuk analisis terperinci. Untuk informasi selengkapnya tentang segmen, lihat Konsep bagian berikut.

X-Ray melacak aplikasi Anda saat berinteraksi dengan node layanan, atau komponen, untuk melayani permintaan yang masuk sebagai berikut:

  1. X-Ray menggunakan id jejak dan segmen untuk melacak interaksi individu.

  2. AWS Agen mengumpulkan id jejak dan segmen terkait, lalu meneruskannya ke kerangka kerja SDK atau API trace.

  3. X-Ray juga melacak interaksi dengan AWS layanan apa pun yang terintegrasi dengan X-Ray.

  4. Agen mengirimkan data ke GUI konsol, tempat Anda dapat melihat informasi tentang jejak, segmen, dan subsegmen, serta cara komponen ini berinteraksi.

Langkah-langkah sebelumnya ditunjukkan pada diagram berikut:

X-Ray menampilkan informasi rinci tentang permintaan aplikasi.

Bagaimana X-Ray berinteraksi dengan aplikasi instrumentasi Anda

Ketika aplikasi instrumentasi Anda menerima permintaan, X-Ray melakukan hal berikut:

  1. Setelah aplikasi Anda melayani permintaan, X-Ray SDK mengirimkan data jejak ke AWS kolektor atau agen. Kemudian, agen mengumpulkan id jejak dan segmen. Anda dapat memilih dari tiga agen berikut:

    • AWS Distro untuk OpenTelemetry (ADOT) Collector - Kolektor sumber terbuka yang dioptimalkan dan diamankan oleh AWS, berdasarkan agen standar sumber terbuka. OpenTelemetry Gunakan ADOT Collector jika Anda ingin menggunakan bahasa dan kode standar vendor-agnostik untuk berinteraksi dengan agen tetapi masih memiliki kepercayaan AWS keamanan dan pengoptimalan yang dibangun ke dalam produk akhir. Anda juga dapat menggunakan ADOT untuk mengonfigurasi titik akhir ke agen dan backend yang berbeda.

    • CloudWatchAgen Amazon — Kolektor sumber terbuka yang mengintegrasikan log, metrik, dan jejak, mendukung semua data telemetri, dan terintegrasi ke dalamnya. ADOT Collector

    • X-Ray daemon — Kolektor yang bekerja dengan X-Ray SDK dan X-Ray API. Gunakan daemon X-Ray jika Anda memiliki kode lama, atau memiliki aplikasi yang memerlukan penelusuran khusus dan karenanya harus menggunakan API X-Ray. Daemon tersedia untukLinux,, dan Microsoft WindowsmacOS, dan disertakan pada AWS Elastic Beanstalk dan AWS Lambda platform.

  2. Kemudian, agen mengirimkan data ini ke kerangka penelusuran yang terdiri dari AWS API, atau AWS SDK yang dibangun di atas API. Kerangka kerja ini berinteraksi dengan AWS layanan lain. X-Ray API menyediakan akses ke semua fungsionalitas X-Ray melalui AWS SDK, AWS Command Line Interface, atau langsung di atasHTTPS. Gunakan X-Ray API jika Anda menggunakan bahasa atau memerlukan operasi yang tidak didukung oleh SDK.

    Anda dapat menggunakan SDK berikut:

    • ADOTSDK — Gunakan ADOT SDK untuk berinteraksi dengan agen yang berbeda dari vendor yang tidak berafiliasi dengannya. AWSADOTSDK juga mendukung beberapa layanan backend.

    • X-Ray SDK — Produk klasik yang tidak lagi menambahkan lebih banyak fitur atau bahasa. Gunakan X-Ray SDK jika Anda tidak ingin memperbarui kode aplikasi Anda.

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

    • Gunakan X-Ray atau ADOT SDK dengan CloudWatch agen — direkomendasikan.

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

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

    • Gunakan X-Ray SDK dengan daemon X-Ray - Gunakan ini jika Anda ingin terus menggunakan X-Ray SDK.

  3. (Opsional) Kerangka penelusuran dapat berinteraksi dengan AWS layanan lain, HTTP server, metode dan kueri lainnya. Beberapa AWS layanan yang terintegrasi dengan X-Ray termasuk Amazon EC2 Amazon SNS dan API Gateway. SDK atau API melacak data jejak selama interaksi ini.

    AWS layanan yang terintegrasi dengan X-Ray dapat menambahkan header penelusuran ke permintaan yang masuk, mengirim data jejak ke X-Ray, atau menjalankan agen untuk mengumpulkan data jejak. Misalnya, AWS Lambda dapat mengirim data jejak tentang permintaan ke fungsi Lambda Anda.

    Untuk informasi lebih lanjut tentang layanan lain yang bekerja dengan X-Ray, lihatIntegrasikan AWS X-Ray dengan yang lain Layanan AWS.

  4. Anda dapat melihat data di konsol tentang jejak, segmen, dan subsegmen Anda dalam antarmuka pengguna grafis (GUI). Anda dapat menggunakan opsi berikut:

X-Ray menggunakan data jejak dari AWS sumber daya yang berinteraksi dengan aplikasi Anda untuk menghasilkan peta jejak yang mendetail. Peta jejak menunjukkan klien, layanan front-end Anda, dan layanan backend yang dipanggil layanan front-end Anda dalam satu permintaan. Gunakan peta jejak untuk kemacetan identitas, lonjakan latensi, dan masalah lainnya untuk menyelesaikan atau meningkatkan kinerja aplikasi Anda.

X-Ray juga akan menghasilkan peta layanan yang memberikan tampilan keseluruhan tentang bagaimana aplikasi Anda berinteraksi dengan node layanan Anda. Tepi di peta layanan menghubungkan node layanan. Mereka menunjukkan seberapa sering node berkomunikasi satu sama lain dan latensi untuk komunikasi tersebut.

Gambar berikut menunjukkan contoh peta layanan, yang menampilkan bagaimana aplikasi Anda berinteraksi dengan komponen yang berbeda. Anda dapat melihat peta layanan di konsol. Gambar menunjukkan aplikasi yang menerima permintaan dari klien. Kemudian, gambar menunjukkan bagaimana aplikasi berinteraksi dengan dua tabel DynamoDB dan Amazon SNS.

Peta jejak menunjukkan klien, layanan front-end, dan layanan backend yang dipanggil layanan front-end Anda untuk memproses permintaan dan mempertahankan data

Gambar berikut adalah contoh data yang tersedia di konsol untuk satu segmen dalam jejak. Gambar menunjukkan garis waktu yang mencantumkan beberapa segmen dan waktu dan durasi mulai yang dijalankan setiap segmen dalam kaitannya dengan yang lain. Gambar juga menunjukkan status segmen, dan kode respons HTTP.

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

Konsep

AWS X-Ray menerima data dari layanan sebagai segmen. X-Ray kemudian mengelompokkan segmen yang memiliki permintaan umum ke penelusuran. X-Ray memproses pelacakan untuk menghasilkan Grafik layanan yang menyediakan representasi visual dari aplikasi Anda.

Segmen

Sumber daya komputasi menjalankan logika aplikasi Anda mengirim data tentang pekerjaan mereka sebagai segmen. Segmen menyediakan nama sumber daya, detail tentang permintaan dan pekerjaan yang dilakukan. Misalnya, ketika permintaan HTTP mencapai aplikasi Anda, dapat mencatat data berikut tentang:

  • Host — nama host, alias atau alamat IP.

  • Permintaan — metode, alamat klien, jalur, agen pengguna.

  • Tanggapan — status, konten.

  • Pekerjaan yang dilakukan — waktu mulai dan akhir, subsegmen.

  • Masalah yang terjadi – kesalahan, kesalahan dan pengecualian, termasuk penangkapan otomatis tumpukan pengecualian.

Gambar berikut adalah contoh informasi ikhtisar yang dikembalikan tentang segmen. Gambar menunjukkan informasi tentang id, waktu mulai dan berakhir, kesalahan atau kesalahan, dan kode permintaan dan respons dari permintaan HTTP:

Segmen data untuk jejak X-Ray

Kerangka penelusuran, yang terdiri dari SDK atau API, mengumpulkan informasi dari header permintaan dan respons, kode dalam aplikasi Anda, dan metadata tentang AWS sumber daya tempat aplikasi Anda berjalan. Anda memilih data mana yang dikumpulkan X-Ray dengan memodifikasi konfigurasi atau kode aplikasi Anda untuk menginstruksikan permintaan masuk, permintaan hilir, dan layanan. AWS

Permintaan yang Diteruskan

Jika penyeimbang beban atau perantara lainnya meneruskan permintaan ke aplikasi Anda, X-Ray akan mengambil IP klien dari header X-Forwarded-For dalam permintaan bukan dari sumber IP dalam paket IP. IP klien yang dicatat untuk permintaan yang diteruskan dapat ditiru, sehingga tidak dapat dipercaya.

Anda dapat menggunakan kerangka kerja penelusuran seperti SDK atau API untuk merekam informasi selengkapnya termasuk anotasi dan metadata. Untuk detail tentang struktur segmen dan subsegmen serta informasi yang direkam, lihatDokumen segmen X-Ray. Dokumen segmen bisa berukuran hingga 64 kB.

Subsegmen

Anda dapat membagi segmen menjadi subsegmen. Subsegmen memberikan informasi waktu yang lebih terperinci dan detail tentang panggilan hilir yang dibuat aplikasi Anda untuk melayani permintaan asli. Subsegmen berisi rincian tambahan tentang panggilan ke Layanan AWS, API HTTP eksternal, atau database SQL. Anda juga dapat menentukan subsegmen untuk instrumen fungsi tertentu atau baris kode dalam aplikasi Anda.

Subsegmen memberikan informasi yang lebih terperinci daripada segmen

X-Ray menggunakan subsegmen untuk menghasilkan segmen yang disimpulkan dan node hilir pada peta jejak untuk layanan yang tidak mengirim segmennya sendiri, seperti Amazon DynamoDB. Subsegmen memungkinkan Anda melihat semua dependensi hilir Anda, bahkan jika dependensi tidak mendukung penelusuran, atau berada di luar. AWS

Subsegmen mewakili tampilan aplikasi Anda dari panggilan hilir sebagai klien. Jika layanan hilir juga diinstrumentasi, segmennya menggantikan segmen yang disimpulkan dari subsegmen klien hulu. Node pada grafik layanan menggunakan informasi dari segmen layanan, jika tersedia. Tepi antara dua node menggunakan subsegmen layanan upstream.

Misalnya, saat Anda memanggil DynamoDB dengan klien SDK yang AWS diinstrumentasi, X-Ray SDK merekam subsegmen untuk panggilan tersebut. DynamoDB tidak mengirim segmen, sehingga subsegmen berisi informasi tentang hal berikut:

  • Segmen yang disimpulkan dalam jejak.

  • DynamoDB; node pada grafik layanan.

  • Tepi antara layanan Anda dan DynamoDB.

Diagram berikut menunjukkan peta layanan untuk aplikasi sampel. Dalam gambar, klien membuat permintaan ke aplikasi Scorekeep sampel. Aplikasi Scorekeep membuat dua panggilan ke DynamoDB. Tepi di peta layanan mewakili setiap panggilan ini. Pilih edge untuk melihat status kesehatan, nomor, dan frekuensi panggilan yang dilakukan ke tabel DynamoDB. Gambar berikut menunjukkan jejak yang sesuai dengan tepi yang difilter berdasarkan waktu respons.

Edge menghubungkan aplikasi instrumentasi dan tabel DynamoDB.

Saat Anda memanggil layanan instrumentasi lain dengan aplikasi berinstrumen, layanan hilir mengirimkan segmennya sendiri. Segmen ini mencatat pandangannya tentang panggilan yang sama dengan layanan hulu yang direkam dalam subsegmen. Dalam grafik layanan, kedua node layanan berisi informasi waktu dan kesalahan dari segmennya. Tepi di antara mereka berisi informasi dari subsegmen layanan hulu. Layanan hilir mencatat kapan mulai dan berakhir bekerja berdasarkan permintaan. Layanan hulu mencatat latensi pulang pergi, termasuk waktu yang dihabiskan permintaan untuk bepergian antara kedua layanan.

Gambar berikut menunjukkan informasi jejak yang difilter oleh waktu respons dari tepi yang sesuai dengan fungsi Lambda hulu.

Waktu respons ditampilkan sebagai nilai dari waktu ke waktu untuk permintaan dari aplikasi berinstrumen yang memanggil aplikasi berinstrumen lain.

Grafik layanan

X-Ray menggunakan data yang dikirimkan aplikasi Anda untuk menghasilkan Grafik layanan. Setiap AWS sumber daya yang mengirimkan data ke X-Ray muncul sebagai node layanan dalam grafik. Edges menghubungkan layanan yang bekerja sama untuk melayani permintaan, menghubungkan klien ke aplikasi Anda, dan menghubungkan aplikasi Anda ke layanan hilir dan sumber daya yang digunakannya.

Nama Layanan

Segmen name mesti sesuai dengan nama domain atau nama logis dari layanan yang menghasilkan segmen. Walau bagaimanapun, ini tidak dipaksakan. Aplikasi apa pun yang memiliki izin untuk PutTraceSegments dapat mengirim segmen dengan nama apa pun.

Sebuah grafik layanan adalah dokumen JSON yang berisi informasi tentang layanan dan sumber daya yang membentuk aplikasi Anda. Konsol X-Ray menggunakan grafik layanan untuk menghasilkan visualisasi atau Peta layanan.

Gambar berikut menunjukkan peta layanan. Peta layanan menampilkan hubungan antara permintaan klien ke aplikasi Anda dan layanan yang berinteraksi dengan aplikasi Anda untuk melayani permintaan. Pada gambar berikut, contoh aplikasi Scorekeep berinteraksi dengan dua tabel DynamoDB dan Amazon SNS.

Peta jejak

Dalam aplikasi terdistribusi, X-Ray menggabungkan node dari semua layanan yang memproses permintaan dengan ID jejak yang sama ke dalam grafik layanan tunggal. Layanan pertama yang berinteraksi dengan permintaan menambahkan header penelusuran yang disebarkan antara front end dan layanan yang dipanggilnya.

Misalnya, Scorekeep menjalankan API web yang memanggil AWS Lambda fungsi untuk menghasilkan nama acak. Kemudian, X-Ray SDK menghasilkan ID jejak dan melacak panggilan ke fungsi Lambda. AWS Lambda meneruskan data penelusuran dan ID jejak ke fungsi Lambda. X-Ray SDK juga menggunakan ID jejak yang sama untuk mengirim data ke agen atau kolektor. Akibatnya, node untuk API, AWS Lambda layanan, dan fungsi Lambda semuanya muncul sebagai node terpisah tetapi terhubung pada peta jejak.

Data grafik layanan dipertahankan selama 30 hari.

Pelacakan

Penelusuran mengumpulkan semua segmen yang dihasilkan oleh satu permintaan. Jejak menggunakan ID jejak untuk melacak jalur permintaan melalui aplikasi Anda. Permintaan itu biasanya permintaan HTTP GET atau POST yang berjalan melalui penyeimbang beban, berinteraksi dengan kode aplikasi Anda, dan menghasilkan panggilan hilir ke AWS layanan lain atau API web eksternal. Layanan yang didukung pertama yang berinteraksi dengan permintaan HTTP menambahkan header ID jejak ke permintaan. Layanan kemudian dan menyebarkan ID jejak ke hilir untuk melacak latensi, disposisi, dan data permintaan lainnya.

Gambar berikut menunjukkan contoh aplikasi yang melayani HTTP permintaan. Ringkasan jejak berisi kode HTTP respons, waktu untuk melayani permintaan, dan berapa lama aplikasi melayani permintaan. Gambar berikut juga menunjukkan garis waktu untuk setiap segmen jejak. Garis waktu menunjukkan status, kode HTTP respons, dan waktu yang dibutuhkan segmen untuk menyelesaikannya. Bagan menunjukkan durasi, waktu mulai dan akhir setiap segmen dalam jejak sehubungan dengan segmen lainnya.

Gambaran linimasa dari penelusuran, yang mengumpulkan semua segmen yang dihasilkan oleh satu permintaan.

Untuk informasi selengkapnya tentang bagaimana tagihan X-Ray melacak pengumpulan, lihat AWS X-Ray harga untuk informasi tentang cara penagihan jejak X-Ray. Data jejak disimpan selama 30 hari.

Pengambilan sampel

X-Ray SDK menerapkan algoritma sampling untuk memastikan penelusuran yang efisien dan memberikan sampel representatif dari permintaan yang dilayani aplikasi Anda. Algoritma ini menentukan permintaan mana yang dilacak. Secara default, X-Ray SDK mencatat permintaan pertama yang diterima pada awal setiap detik, dan lima persen dari permintaan tambahan apa pun.

Untuk menghindari timbulnya biaya layanan ketika Anda memulai, hitungan sampling default adalah konservatif. Anda dapat mengonfigurasi X-Ray untuk mengubah laju pengambilan sampel default dan mengonfigurasi aturan tambahan yang menerapkan pengambilan sampel berdasarkan properti layanan atau permintaan.

Misalnya, Anda mungkin ingin menonaktifkan sampling dan melacak semua permintaan panggilan yang mengubah status atau menangani pengguna atau transaksi. Untuk panggilan read-only volume tinggi, seperti polling latar belakang, pemeriksaan kesehatan, atau pemeliharaan koneksi.

Untuk informasi selengkapnya, lihat Konfigurasikan aturan pengambilan sampel dan CreateSamplingRuleAPI.

Header penelusuran

Semua permintaan dilacak, hingga jumlah minimum, yang dapat Anda konfigurasikan. Setelah mencapai minimum itu, X-Ray hanya melacak persentase permintaan untuk menghindari biaya tambahan. X-Ray menambahkan keputusan pengambilan sampel dan melacak ID ke permintaan HTTP dalam melacak header yang dimulai dengan. X-Amzn-Trace-Id X-Ray menambahkan header ini ketika permintaan berinteraksi dengan AWS layanan pertama yang terintegrasi dengan X-Ray. X-Ray SDK membaca header ini dan memasukkannya ke dalam respons.

contoh Header pelacakan dengan akar pelacakan ID dan pengambilan sampel keputusan
X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Sampled=1
Keamanan Header Pelacakan

Header penelusuran dapat berasal dari X-Ray SDK Layanan AWS, atau permintaan klien. Aplikasi Anda dapat menghapus X-Amzn-Trace-Id dari permintaan masuk untuk menghindari masalah yang disebabkan oleh pengguna penambahan ID penelusuran atau pengambilan sampel keputusan untuk permintaan mereka.

Header pelacakan juga dapat berisi ID segmen induk jika permintaan berasal dari aplikasi terinstrumen. Misalnya, jika aplikasi Anda memanggil API web HTTP hilir dengan klien HTTP yang diinstrumentasi, SDK X-Ray menambahkan ID segmen untuk permintaan asli ke header pelacakan permintaan hilir. Aplikasi berinstrumen yang melayani permintaan hilir menggunakan ID segmen induk untuk menghubungkan dua permintaan.

contoh Header pelacakan dengan akar penelusuran ID dan pengambilan sampel keputusan
X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1

Lambda atau lainnya Layanan AWS mungkin menambahkan bagian dari header yang dimulai dengan Lineage sebagai bagian dari mekanisme pemrosesan mereka. Anda tidak boleh langsung menggunakan bagian yang ditambahkan dari header jejak.

contoh Menelusuri header dengan Lineage
X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Sampled=1;Lineage=a87bd80c:1|68fd508a:5|c512fbe3:2

Ekspresi Filter

Bahkan jika Anda mengambil sampel sebagian kecil data, aplikasi yang kompleks dapat menghasilkan banyak data jejak. Gunakan ekspresi filter untuk dapat menemukan jejak tertentu termasuk untuk permintaan individu, jalur tertentu, atau pengguna.

Gambar berikut menunjukkan kotak teks di konsol X-Ray yang dapat Anda gunakan untuk memfilter menurut grup yang Anda tentukan. Untuk informasi selengkapnya tentang grup, lihat bagian berikut Grup.

Pilih jejak untuk melihat detail tentang permintaan individual

Grup

Anda dapat menggunakan grup di dalam ekspresi filter untuk mengurangi jumlah data jejak dan fokus pada data yang sesuai dengan kriteria grup.

Gunakan grup untuk menghasilkan grafik layanan, melacak ringkasan, dan CloudWatch metrik yang spesifik untuk grup tersebut. Anda dapat menelepon dengan nama atau dengan Amazon Resource Name (ARN). X-Ray memeriksa jejak yang masuk terhadap ekspresi filter grup saat disimpan dalam layanan X-Ray. CloudWatchmenerbitkan metrik untuk jejak yang sesuai dengan kriteria grup setiap menit.

Memperbarui ekspresi filter grup tidak mengubah data yang sudah dicatat. Pembaruan hanya berlaku untuk pelacakan berikutnya. Hal ini dapat mengakibatkan grafik gabungan dari ekspresi baru dan lama. Untuk menghindari penggabungan grup yang tidak terhubung di dalam satu grafik, hapus grup saat ini dan https://docs.aws.amazon.com/xray/latest/api/API_CreateGroup.html buat yang baru.

catatan

Penagihan untuk grup didasarkan pada jumlah jejak yang diambil yang cocok dengan ekspresi filter. Untuk informasi selengkapnya, lihat Harga AWS X-Ray.

Untuk informasi selengkapnya tentang grup, lihat Konfigurasikan grup.

Anotasi dan metadata

Saat Anda menginstruksikan aplikasi Anda, X-Ray SDK mencatat informasi tentang permintaan masuk dan keluar. SDK juga mencatat informasi tentang AWS sumber daya yang digunakan, dan aplikasi itu sendiri. Anda dapat menambahkan informasi lain ke dokumen segmen sebagai anotasi dan metadata. Anotasi dan metadata digabungkan pada tingkat jejak. Mereka dapat ditambahkan ke segmen atau subsegmen apa pun.

Anotasi adalah pasangan nilai kunci yang diindeks untuk digunakan dengan ekspresi filter. Gunakan anotasi untuk mencatat data yang ingin Anda gunakan untuk mengelompokkan penelusuran pada konsol, atau saat memanggil API GetTraceSummaries.

Indeks X-Ray hingga 50 anotasi per penelusuran.

Metadata adalah pasangan nilai kunci dengan nilai jenis apa pun, termasuk objek dan daftar, yang tidak diindeks. Gunakan metadata untuk mencatat data yang ingin Anda simpan di penelusuran tetapi tidak perlu digunakan untuk mencari pelacakan.

Anda dapat melihat anotasi dan metadata di jendela detail segmen atau subsegmen, di dalam halaman Trace details di konsol. CloudWatch Untuk informasi selengkapnya, lihat Melihat jejak dan melacak detail diJelajahi konsol X-Ray.

Kesalahan, cacat, dan pengecualian

X-Ray melacak kesalahan dalam kode aplikasi Anda dan yang dikembalikan oleh layanan hilir.X-ray melacak kode HTTP respons berikut dari permintaan:

  • Error— Kesalahan klien (kesalahan seri 400) menunjukkan bahwa server tidak dapat memahami atau memproses permintaan dari klien karena permintaan itu sendiri mengandung kesalahan. Kesalahan ini dapat disebabkan oleh kesalahan sintaks, informasi yang hilang atau badan permintaan yang buruk.

  • FaultKesalahan server (kesalahan seri 500) menunjukkan bahwa server tidak dapat memproses permintaan yang valid karena masalah dengan server itu sendiri. Kesalahan ini dapat disebabkan oleh masalah yang mencakup kegagalan dalam perangkat lunak atau perangkat keras, atau keterbatasan sumber daya server.

  • ThrottleKesalahan pelambatan (429 Too Many Requests) adalah jenis kesalahan klien tertentu yang terjadi ketika klien mengirim terlalu banyak permintaan ke server atau API selama periode waktu tertentu.

Jika pengecualian terjadi saat aplikasi Anda menyajikan permintaan yang diinstrumentasi, SDK X-Ray akan mencatat detail tentang pengecualian, termasuk id jejak tumpukan, jika tersedia. Anda dapat melihat pengecualian di bawah Detail Segment di konsol X-Ray.