Gunakan sebuah AWS Management Console

Lihat peta jejak X-Ray untuk mengidentifikasi layanan di mana terjadi kesalahan, koneksi dengan latensi tinggi, atau jejak permintaan yang tidak berhasil.

Melihat peta pelacakan

Peta jejak adalah representasi visual dari data jejak yang dihasilkan oleh aplikasi Anda. Peta menunjukkan node layanan yang melayani permintaan, node klien hulu yang mewakili asal permintaan, dan node layanan hilir yang mewakili layanan web dan sumber daya yang digunakan oleh aplikasi saat memproses permintaan.

Peta jejak menampilkan tampilan jejak yang terhubung di seluruh aplikasi berbasis peristiwa yang menggunakan Amazon SQS dan Lambda. Untuk informasi selengkapnya, lihat bagian Melacak aplikasi berbasis peristiwa berikut. Peta jejak juga mendukung penelusuran lintas akun, menampilkan node dari beberapa akun dalam satu peta.

Memfilter peta jejak menurut grup

Menggunakan ekspresi filter, Anda dapat menentukan kriteria yang digunakan untuk menyertakan jejak dalam grup. Untuk informasi selengkapnya tentang ekspresi filter, lihat Menggunakan ekspresi filter. Selanjutnya, gunakan langkah-langkah berikut untuk kemudian menampilkan grup tertentu di peta jejak.

Peta layanan sekarang akan difilter untuk menampilkan jejak yang cocok dengan ekspresi filter dari grup yang dipilih.

Lacak legenda dan opsi peta

Peta jejak mencakup legenda dan beberapa opsi untuk menyesuaikan tampilan peta.

Gunakan halaman Jejak di konsol X-Ray untuk menemukan jejak berdasarkan URL, kode respons, atau data lain dari ringkasan jejak. Setelah memilih jejak dari daftar jejak, halaman Detail jejak menampilkan peta node layanan yang terkait dengan jejak yang dipilih dan garis waktu segmen jejak.

Melihat pelacakan

Menjelajahi garis waktu jejak

Bagian Timeline menunjukkan hierarki segmen dan subsegmen di sebelah bilah horizontal yang sesuai dengan waktu yang mereka gunakan untuk menyelesaikan tugas mereka. Entri pertama dalam daftar adalah segmen, yang mewakili semua data yang dicatat oleh layanan untuk satu permintaan. Subsegmen diindentasi dan terdaftar mengikuti segmen. Kolom berisi informasi tentang setiap segmen.

Saat Anda menggunakan AWS SDKHTTP, atau SQL klien yang diinstrumentasi untuk melakukan panggilan ke sumber daya eksternal, SDK X-Ray merekam subsegmen secara otomatis. Anda juga dapat menggunakan X-Ray SDK untuk merekam subsegmen kustom untuk fungsi atau blok kode apa pun. Subsegmen tambahan yang direkam saat subsegmen kustom terbuka menjadi turunan dari subsegmen kustom.

Melihat detail segmen

Dari garis waktu jejak, pilih nama segmen untuk melihat detailnya.

Panel detail Segmen menampilkan tab Ikhtisar, Sumber Daya, Anotasi, Metadata, Pengecualian, dan SQL. Berikut ini berlaku:

Melihat detail subsegmen

Dari timeline trace, pilih nama subsegmen untuk melihat detailnya:

Untuk subsegment kustom, tab Gambaran Umum menunjukkan nama subsegmen, yang dapat Anda atur untuk menentukan area kode atau fungsi yang dicatat. Untuk informasi selengkapnya, lihat tautan khusus bahasa yang tercantum di bawah Menginstrumentasi aplikasi Anda dengan AWS X-Ray SDK di. Membuat subsegmen kustom dengan X-Ray SDK for Java

Gambar berikut menunjukkan tab Ikhtisar untuk subsegmen kustom. Ikhtisar berisi ID subsegmen, ID induk, Nama, waktu mulai dan akhir, durasi, status, dan kesalahan atau kesalahan.

Tab Metadata untuk subsegmen kustom berisi informasi dalam JSON format tentang sumber daya yang digunakan oleh subsegmen tersebut.

Gunakan ekspresi filter untuk melihat peta jejak atau jejak untuk permintaan tertentu, layanan, koneksi antara dua layanan (tepi), atau permintaan yang memenuhi suatu kondisi. X-Ray menyediakan bahasa ekspresi filter untuk memfilter permintaan, layanan, dan edge berdasarkan data dalam header permintaan, status respons, dan bidang yang diindeks pada segmen asli.

Ketika Anda memilih jangka waktu pelacakan untuk dilihat di konsol X-Ray, Anda mungkin mendapatkan lebih banyak hasil daripada yang dapat ditampilkan konsol tersebut. Di sudut kanan atas, konsol menunjukkan jumlah pelacakan yang dipindai dan apakah ada lebih banyak pelacakan yang tersedia. Anda dapat menggunakan ekspresi filter untuk mempersempit hasil hanya jejak yang ingin Anda temukan.

Saat Anda memilih node di peta jejak, konsol akan membuat ekspresi filter berdasarkan nama layanan node, dan jenis kesalahan yang ada berdasarkan pilihan Anda. Untuk menemukan pelacakan yang menunjukkan masalah performa atau yang terkait dengan permintaan tertentu, Anda dapat menyesuaikan ekspresi yang disediakan konsol tersebut atau membuat ekspresi Anda sendiri. Jika Anda menambahkan anotasi dengan X-Ray SDK, Anda juga dapat mem-filter berdasarkan keberadaan kunci anotasi atau nilai kunci.

catatan

Jika Anda memilih rentang waktu relatif di peta jejak dan memilih simpul, konsol mengubah rentang waktu menjadi waktu mulai dan berakhir mutlak. Untuk memastikan bahwa pelacakan untuk simpul muncul di hasil pencarian, dan menghindari waktu pemindaian saat simpul tidak aktif, rentang waktu hanya mencakup waktu ketika simpul mengirim pelacakan. Untuk mencari relatif terhadap waktu saat ini, Anda dapat beralih kembali ke rentang waktu relatif di halaman pelacakan dan memindai kembali.

Jika masih ada lebih banyak hasil yang tersedia daripada yang dapat ditampilkan konsol, konsol menunjukkan kepada Anda berapa banyak pelacakan yang cocok dan jumlah pelacakan yang dipindai. Persentase yang ditampilkan adalah persentase dari kerangka waktu yang dipilih yang dipindai. Untuk memastikan bahwa Anda melihat semua pelacakan yang cocok terwakili dalam hasil, persempit ekspresi filter Anda lebih lanjut, atau pilih jangka waktu yang lebih singkat.

Untuk mendapatkan hasil terbaru terlebih dahulu, konsol mulai memindai pada akhir rentang waktu dan bekerja mundur. Jika ada banyak pelacakan, tetapi sedikit hasil, konsol tersebut membagi rentang waktu menjadi beberapa bagian dan memindainya secara paralel. Bilah kemajuan menunjukkan bagian dari rentang waktu yang telah dipindai.

Grup adalah kumpulan pelacakan yang ditentukan oleh ekspresi filter. Anda dapat menggunakan grup untuk menghasilkan grafik layanan tambahan dan menyediakan CloudWatch metrik Amazon.

Grup diidentifikasi berdasarkan namanya atau Amazon Resource Name (ARN), dan berisi ekspresi filter. Layanan membandingkan pelacakan yang masuk dengan ekspresi dan menyimpannya sesuai dengan itu.

Anda dapat membuat dan memodifikasi grup dengan menggunakan menu tarik-turun di sebelah kiri bilah pencarian ekspresi filter.

catatan

Jika layanan mengalami kesalahan dalam kualifikasi grup, grup tersebut tidak lagi disertakan dalam memproses pelacakan masuk dan metrik kesalahan dicatat.

Untuk informasi selengkapnya tentang grup opsi, lihat Konfigurasikan grup.

Ekspresi filter dapat berisi Kata Kunci, unary atau biner Operator, dan nilai untuk perbandingan.

keyword operator value

Operator yang berbeda tersedia untuk berbagai tipe kata kunci. Misalnya, responsetime adalah kata kunci nomor dan dapat dibandingkan dengan operator yang terkait dengan nomor.

contoh – permintaan saat waktu respons lebih besar dari 5 detik

responsetime > 5

Anda dapat menggabungkan beberapa ekspresi dalam ekspresi gabungan dengan menggunakan operator AND atau OR.

contoh – permintaan saat total durasi adalah 5-8 detik

duration >= 5 AND duration <= 8

Kata kunci dan operator sederhana hanya menemukan masalah di tingkat penelusuran. Jika kesalahan terjadi di hilir, tetapi ditangani oleh aplikasi Anda dan tidak dikembalikan ke pengguna, pencarian untuk error tidak akan menemukannya.

Untuk menemukan jejak dengan masalah hilir, Anda dapat menggunakan kata kunci yang kompleks service() danedge(). Kata kunci ini memungkinkan Anda menerapkan ekspresi filter ke semua simpul hilir, satu simpul hilir, atau tepi di antara dua simpul. Untuk selengkapnya tentang kata kunci ini, lihat bagian Kata kunci kompleks berikut. Untuk perincian lebih lanjut, Anda dapat memfilter layanan dan edge berdasarkan tipe dengan fungsi id(). Untuk informasi selengkapnya lihat bagian fungsi id berikut.

Nilai kata kunci Boolean adalah BETUL atau SALAH. Gunakan kata kunci ini untuk menemukan pelacakan yang mengakibatkan kesalahan.

Kata Kunci Boolean

• ok – Kode status respons 2XX Berhasil.

• error – Kode status respons 4XX Kesalahan Klien.

• throttle – Kode status respons 429 Terlalu Banyak Permintaan.

• fault – Kode status respons 5XX Kesalahan Server.

• partial – Permintaan memiliki segmen yang tidak lengkap.

• inferred – Permintaan memiliki segmen yang disimpulkan.

• first - Elemen adalah yang pertama dari daftar enumerasi.

• last - Elemen adalah yang terakhir dari daftar enumerasi.

• remote – Entitas akar masalah jarak jauh.

• root – Layanan adalah titik masuk atau segmen akar dari suatu pelacakan.

Operator Boolean menemukan segmen saat kunci yang ditentukan adalah true atau false.

Operator Boolean

• Tidak ada - Ekspresi benar jika kata kunci benar.

• ! - Ekspresi benar jika kata kunci salah.

• =,!= – Bandingkan nilai kata kunci dengan string true atau false. Operator ini bertindak sama dengan operator lain tetapi lebih eksplisit.

contoh – status respons 2XX OK

ok

contoh – status respons bukan 2XX OK

!ok

contoh – status respons bukan 2XX OK

ok = false

contoh – pelacakan kesalahan yang disebutkan terakhir memiliki nama kesalahan "deserialize"

rootcause.fault.entity { last and name = "deserialize" }

contoh – permintaan dengan segmen jarak jauh saat cakupan lebih besar dari 0,7 dan nama layanannya adalah "pelacakan"

rootcause.responsetime.entity { remote and coverage > 0.7 and name = "traces" }

contoh – permintaan dengan segmen yang disimpulkan dengan tipe layanan "AWS:DynamoDB"

rootcause.fault.service { inferred and name = traces and type = "AWS::DynamoDB" }

contoh – permintaan yang memiliki segmen dengan nama "data-plane" sebagai root

service("data-plane") {root = true and fault = true}

Gunakan kata kunci angka untuk mencari permintaan dengan waktu respons, durasi, atau status respons tertentu.

Kata Kunci nomor

• responsetime – Waktu yang dibutuhkan server untuk mengirim respons.

• duration – Total permintaan, termasuk semua panggilan hilir.

• http.status – Kode status respons.

• index – Posisi elemen dalam daftar enumerasi.

• coverage – Persentase desimal waktu respons entitas selama waktu respons segmen akar. Hanya berlaku untuk entitas akar masalah waktu respons.

Operasi nomor

Kata kunci angka menggunakan persamaan standar dan operator perbandingan.

• =,!= – Kata kunci sama dengan atau tidak sama dengan nilai angka.

• <,<=, >,>= – Kata kunci kurang dari atau lebih besar dari nilai angka.

contoh – status respons bukan 200 OK

http.status != 200

contoh – permintaan saat total durasinya adalah 5–8 detik

duration >= 5 AND duration <= 8

contoh – permintaan yang berhasil diselesaikan dalam waktu kurang dari 3 detik, termasuk semua panggilan hilir

ok !partial duration <3

contoh – entitas daftar enumerasi yang memiliki indeks lebih besar dari 5

rootcause.fault.service { index > 5 }

contoh – permintaan saat entitas terakhir yang memiliki cakupan lebih besar dari 0,8

rootcause.responsetime.entity { last and coverage > 0.8 }

Gunakan kata kunci string untuk menemukan pelacakan dengan teks tertentu di header permintaan, atau ID pengguna tertentu.

Kata Kunci String

• http.url – Meminta URL.

• http.method – Metode permintaan.

• http.useragent – Meminta string agen pengguna.

• http.clientip – Alamat IP Peminta.

• user – Nilai dari bidang pengguna pada setiap segmen dalam pelacakan.

• name – Nama layanan atau pengecualian.

• type – Tipe Layanan.

• message – Pesan pengecualian.

• availabilityzone – Nilai ketersediaan bidang zona pada setiap segmen dalam pelacakan.

• instance.id – Nilai bidang ID instans pada setiap segmen dalam pelacakan.

• resource.arn – Nilai bidang ARN sumber daya pada setiap segmen dalam pelacakan.

Operator string menemukan nilai yang sama dengan atau berisi teks tertentu. Nilai harus selalu ditentukan dalam tanda kutip.

Operator String

• =,!= – Kata kunci adalah sama dengan atau tidak sama dengan nilai angka.

• CONTAINS – Kata kunci berisi string tertentu.

• BEGINSWITH , ENDSWITH – Kata kunci dimulai atau diakhiri dengan string tertentu.

contoh – filter http.url

http.url CONTAINS "/api/game/"

Untuk menguji apakah suatu bidang ada pada pelacakan, terlepas dari nilainya, periksa untuk melihat apakah bidang tersebut berisi string kosong.

contoh – filter pengguna

Temukan semua pelacakan dengan ID pengguna.

user CONTAINS ""

contoh – pilih pelacakan dengan penyebab akar masalah yang mencakup layanan bernama "Auth"

rootcause.fault.service { name = "Auth" }

contoh – pilih pelacakan dengan akar masalah waktu respons yang layanan terakhirnya memiliki tipe DynamoDB

rootcause.responsetime.service { last and type = "AWS::DynamoDB" }

contoh – pilih pelacakan dengan akar penyebab kesalahan yang pengecualian terakhirnya memiliki pesan "akses ditolak untuk akun_id: 1234567890"

rootcause.fault.exception { last and message = "Access Denied for account_id: 1234567890" 

Gunakan kata kunci yang kompleks untuk menemukan permintaan berdasarkan nama layanan, nama edge, atau nilai anotasi. Untuk layanan dan edge, Anda dapat menentukan ekspresi filter tambahan yang berlaku untuk layanan atau edge. Untuk anotasi, Anda dapat memfilter nilai anotasi dengan kunci tertentu menggunakan operator Boolean, angka, atau string.

Kata Kunci Kompleks

• annotation.key - Nilai anotasi dengan bidang kunci. Nilai anotasi dapat menjadi Boolean, nomor, atau string, sehingga Anda dapat menggunakan salah satu operator perbandingan tipe tersebut. Anda dapat menggunakan kata kunci ini dalam kombinasi dengan edge kata kunci service atau.

• edge(source, destination) {filter} – Koneksi antar layanan sumber dan Tujuan. Kawat lengkung opsional dapat berisi ekspresi filter yang berlaku untuk segmen pada koneksi ini.

• group.name / group.arn – Nilai ekspresi filter grup, yang dirujuk oleh nama grup atau ARN grup.

• json – objek akar masalah JSON. Lihat Mendapatkan data dari AWS X-Ray untuk langkah-langkah membuat entitas JSON secara terprogram.

• service(name) {filter} – Layanan dengan nama nama. Kawat lengkung opsional dapat berisi ekspresi filter yang berlaku untuk segmen yang dibuat oleh layanan.

Gunakan kata kunci layanan untuk menemukan jejak permintaan yang mengenai node tertentu di peta jejak Anda.

Operator kata kunci yang kompleks menemukan segmen saat kunci yang ditentukan telah diset, atau tidak diset.

Operator kata kunci kompleks

• Tidak ada - Ekspresi benar jika kata kunci diset. Jika kata kunci bertipe boolean, maka akan dievaluasi ke nilai boolean.

• ! – Ekspresi benar jika kata kunci tidak diset. Jika kata kunci bertipe boolean, maka akan dievaluasi ke nilai boolean.

• =,!= – Bandingkan nilai kata kunci.

• edge(source, destination) {filter} – Koneksi antar layanan sumber dan Tujuan. Kawat lengkung opsional dapat berisi ekspresi filter yang berlaku untuk segmen pada koneksi ini.

• annotation.key - Nilai anotasi dengan bidang kunci. Nilai anotasi dapat menjadi Boolean, nomor, atau string, sehingga Anda dapat menggunakan salah satu operator perbandingan tipe tersebut. Anda dapat menggunakan kata kunci ini dalam kombinasi dengan edge kata kunci service atau.

• json – objek akar masalah JSON. Lihat Mendapatkan data dari AWS X-Ray untuk langkah-langkah membuat entitas JSON secara terprogram.

Gunakan kata kunci layanan untuk menemukan jejak permintaan yang mengenai node tertentu di peta jejak Anda.

contoh – Filter layanan

Permintaan yang mencakup panggilan ke api.example.com dengan kesalahan (kesalahan seri 500).

service("api.example.com") { fault }

Anda dapat mengecualikan nama layanan untuk menerapkan ekspresi filter ke semua simpul di peta layanan Anda.

contoh – Filter layanan

Permintaan yang menyebabkan kesalahan di mana saja di peta jejak Anda.

service() { fault }

Kata kunci edge menerapkan ekspresi filter ke koneksi antara dua simpul.

contoh – filter edge

Permintaan saat layanan api.example.com melakukan panggilan ke backend.example.com yang gagal dengan kesalahan.

edge("api.example.com", "backend.example.com") { error }

Anda juga dapat menggunakan operator ! dengan kata kunci layanan dan edge untuk mengecualikan layanan atau edge dari hasil ekspresi filter lain.

contoh – filter layanan dan permintaan

Permintaan saat URL dimulai dengan http://api.example.com/ dan berisi /v2/ tetapi tidak menjangkau layanan bernama api.example.com.

http.url BEGINSWITH "http://api.example.com/" AND http.url CONTAINS "/v2/" AND !service("api.example.com")

contoh – filter layanan dan waktu respons

Temukan pelacakan saat http url diset dan waktu respons lebih dari 2 detik.

http.url AND responseTime > 2

Untuk anotasi, Anda dapat menghubungi semua pelacakan tempat annotation.key diatur, atau menggunakan operator perbandingan yang sesuai dengan tipe nilai.

contoh – anotasi dengan nilai string

Permintaan dengan anotasi bernama gameid dengan nilai string "817DL6VO".

annotation.gameid = "817DL6VO"

contoh – anotasi diset

Permintaan dengan anotasi bernama set age.

annotation.age

contoh – anotasi tidak diset

Permintaan tanpa anotasi bernama set age.

!annotation.age

contoh – anotasi dengan nilai angka

Permintaan dengan usia anotasi dengan nilai numerik lebih besar dari 29.

annotation.age > 29

contoh — anotasi dalam kombinasi dengan layanan atau tepi

service { annotation.request_id = "917DL6VO" }

edge { source.annotation.request_id = "916DL6VO" }

edge { destination.annotation.request_id = "918DL6VO" }

contoh – grup dengan pengguna

Permintaan saat pelacakan memenuhi filter grup high_response_time (misalnya responseTime > 3), dan pengguna bernama Alice.

group.name = "high_response_time" AND user = "alice"

contoh – JSON dengan akar masalah entitas

Permintaan dengan entitas akar masalah yang cocok.

rootcause.json = #[{ "Services": [ { "Name": "GetWeatherData", "EntityPath": [{ "Name": "GetWeatherData" }, { "Name": "get_temperature" } ] }, { "Name": "GetTemperature", "EntityPath": [ { "Name": "GetTemperature" } ] } ] }]

Ketika Anda memberikan nama layanan untuk kata kunci service atau edge, Anda mendapatkan hasil untuk semua simpul yang memiliki nama tersebut. Untuk pemfilteran yang lebih tepat, Anda dapat menggunakan fungsi id untuk menentukan tipe layanan selain nama untuk membedakan antara simpul dengan nama yang sama.

Gunakan account.id fungsi untuk menentukan akun tertentu untuk layanan, saat melihat jejak dari beberapa akun di akun pemantauan.

id(name: "service-name", type:"service::type", account.id:"account-ID")

Anda dapat menggunakan fungsi id sebagai pengganti nama layanan dalam filter layanan dan edge.

service(id(name: "service-name", type:"service::type")) { filter }

edge(id(name: "service-one", type:"service::type"), id(name: "service-two", type:"service::type")) { filter }

Misalnya, AWS Lambda fungsi menghasilkan dua node di peta jejak; satu untuk pemanggilan fungsi, dan satu untuk layanan Lambda. Kedua simpul memiliki nama yang sama tetapi berbeda tipe. Filter layanan standar akan menemukan pelacakan untuk keduanya.

contoh – Filter layanan

Permintaan yang mencakup kesalahan pada layanan bernama random-name.

service("function-name") { error }

Gunakan fungsi id untuk mempersempit pencarian ke kesalahan pada fungsi itu sendiri, tidak termasuk kesalahan dari layanan.

contoh – filter layanan dengan fungsi id

Permintaan yang mencakup kesalahan pada layanan bernama random-namedengan tipe AWS::Lambda::Function.

service(id(name: "random-name", type: "AWS::Lambda::Function")) { error }

Untuk mencari simpul berdasarkan tipe, Anda juga dapat mengecualikan nama sepenuhnya.

contoh — filter layanan dengan fungsi id dan jenis layanan

Permintaan yang menyertakan kesalahan pada layanan dengan tipe AWS::Lambda::Function.

service(id(type: "AWS::Lambda::Function")) { error }

Untuk mencari node tertentu Akun AWS, tentukan ID akun.

contoh — filter layanan dengan fungsi id dan ID akun

Permintaan yang menyertakan layanan dalam ID akun tertentuAWS::Lambda::Function.

service(id(account.id: "account-id"))

AWS X-Ray mendukung pengamatan lintas akun, memungkinkan Anda untuk memantau dan memecahkan masalah aplikasi yang menjangkau beberapa akun dalam file. Wilayah AWS Anda dapat dengan mulus mencari, memvisualisasikan, dan menganalisis metrik, log, dan jejak Anda di salah satu akun tertaut seolah-olah Anda beroperasi dalam satu akun. Ini memberikan tampilan lengkap permintaan yang melintasi beberapa akun. Anda dapat melihat jejak lintas akun di peta jejak X-Ray dan melacak halaman di dalam CloudWatchkonsol.

Data observabilitas bersama dapat mencakup salah satu jenis telemetri berikut:

Konfigurasikan observabilitas lintas akun

Untuk mengaktifkan observabilitas lintas akun, siapkan satu atau beberapa akun AWS pemantauan dan tautkan dengan beberapa akun sumber. Akun pemantauan adalah pusat Akun AWS yang dapat melihat dan berinteraksi dengan data observabilitas yang dihasilkan dari akun sumber. Akun sumber adalah individu Akun AWS yang menghasilkan data observabilitas untuk sumber daya yang dikandungnya.

Akun sumber membagikan data observabilitas mereka dengan akun pemantauan. Jejak disalin dari setiap akun sumber hingga lima akun pemantauan. Salinan jejak dari akun sumber ke akun pemantauan pertama gratis. Salinan jejak yang dikirim ke akun pemantauan tambahan dibebankan ke setiap akun sumber, berdasarkan harga standar. Untuk informasi selengkapnya, lihat AWS X-Ray harga dan CloudWatch harga Amazon.

Untuk membuat tautan antara akun pemantauan dan akun sumber, gunakan CloudWatch konsol atau perintah Observability Access Manager baru di API AWS CLI dan. Untuk informasi lebih lanjut, lihat CloudWatch observabilitas lintas akun.

Melihat jejak lintas akun

Jejak lintas akun ditampilkan di akun pemantauan. Setiap akun sumber hanya menampilkan jejak lokal untuk akun tertentu. Bagian berikut mengasumsikan bahwa Anda masuk ke akun pemantauan dan telah membuka CloudWatch konsol Amazon. Pada peta jejak dan halaman jejak, lencana akun pemantauan ditampilkan di sudut kanan atas.

Peta jejak

Di CloudWatch konsol, pilih Trace Map di bawah jejak X-Ray dari panel navigasi kiri. Secara default, peta jejak menampilkan node untuk semua akun sumber yang mengirim jejak ke akun pemantauan, dan node untuk akun pemantauan itu sendiri. Pada peta jejak, pilih Filter dari kiri atas untuk memfilter peta jejak menggunakan drop-down Akun. Setelah filter akun diterapkan, node layanan dari akun yang tidak cocok dengan filter saat ini akan berwarna abu-abu.

Saat Anda memilih node layanan, panel rincian node menyertakan ID dan label akun layanan.

Di sudut kanan atas peta jejak, pilih Tampilan daftar untuk melihat daftar node layanan. Daftar node layanan mencakup layanan dari akun pemantauan dan semua akun sumber yang dikonfigurasi. Filter daftar node berdasarkan label Akun atau ID Akun dengan memilihnya dari filter Node.

Pelacakan

Lihat detail jejak untuk jejak yang menjangkau beberapa akun dengan membuka CloudWatch konsol dari akun pemantauan, dan memilih Jejak di bawah jejak X-Ray di panel navigasi kiri. Anda juga dapat membuka halaman ini dengan memilih node di X-Ray Trace Map, dan kemudian memilih Lihat jejak dari panel rincian node.

Halaman Traces mendukung kueri berdasarkan ID akun. Untuk memulai, masukkan kueri yang menyertakan satu atau beberapa ID akun. Untuk informasi selengkapnya tentang kueri, lihatGunakan ekspresi filter. Contoh kueri berikut untuk jejak yang telah melewati ID akun X atau Y:

service(id(account.id:"X")) OR service(id(account.id:"Y"))

Perbaiki kueri Anda berdasarkan Akun. Pilih satu atau beberapa akun dari daftar, dan pilih Tambahkan ke kueri.

Detail jejak

Lihat detail untuk jejak dengan memilihnya dari daftar Jejak di bagian bawah halaman Jejak. Detail Trace ditampilkan, termasuk peta detail jejak dengan node layanan dari seluruh akun yang dilalui oleh jejak. Pilih node layanan tertentu untuk melihat akun yang sesuai.

Bagian timeline Segments menampilkan detail akun untuk setiap segmen di timeline.

AWS X-Ray mendukung penelusuran aplikasi berbasis peristiwa menggunakan Amazon SQS dan. AWS Lambda Gunakan CloudWatch konsol untuk melihat tampilan tersambung dari setiap permintaan saat diantrian dengan Amazon SQS dan diproses oleh satu atau beberapa fungsi Lambda. Jejak dari produsen pesan hulu secara otomatis ditautkan ke jejak dari node konsumen Lambda hilir, menciptakan end-to-end tampilan aplikasi.

Lihat jejak yang ditautkan di peta jejak

Gunakan halaman Trace Map dalam CloudWatchkonsol untuk melihat peta jejak dengan jejak dari produsen pesan yang ditautkan ke jejak dari konsumen Lambda. Tautan ini ditampilkan dengan tepi garis putus-putus yang menghubungkan node Amazon SQS dan node konsumen Lambda hilir.

Pilih tepi garis putus-putus untuk menampilkan histogram usia acara yang diterima, yang memetakan penyebaran usia acara saat diterima oleh konsumen. Usia dihitung setiap kali suatu acara diterima.

Lihat detail jejak yang ditautkan

Peta detail jejak menampilkan jejak saat ini, bersama dengan jejak terkait hulu dan hilir, yang masing-masing terkandung dalam kotak yang menunjukkan batas setiap jejak. Jika jejak yang dipilih saat ini ditautkan ke beberapa jejak hulu atau hilir, node dalam jejak tertaut hulu atau hilir ditumpuk, dan tombol Select trace ditampilkan.

Di bawah peta detail jejak, garis waktu segmen jejak ditampilkan, termasuk jejak tertaut hulu dan hilir. Jika ada beberapa jejak tertaut hulu atau hilir, detail segmennya tidak dapat ditampilkan. Untuk melihat detail segmen untuk satu jejak dalam satu set jejak tertaut, pilih satu jejak seperti yang dijelaskan di bagian berikut.

Pilih satu jejak dalam satu set jejak yang ditautkan

Saat Anda memilih simpul atau tepi pada peta jejak, konsol X-Ray menunjukkan histogram distribusi latensi.

Latensi

Latensi adalah jumlah waktu antara ketika permintaan dimulai dan ketika selesai. Histogram menunjukkan distribusi latensi. Hal tersebut menunjukkan durasi pada sumbu x, dan persentase permintaan yang cocok dengan setiap durasi pada sumbu y.

Histogram ini menunjukkan layanan yang melengkapi sebagian besar permintaan dalam waktu kurang dari 300 milidetik. Sebagian kecil permintaan memakan waktu hingga 2 detik, dan beberapa outlier membutuhkan lebih banyak waktu.

Menafsirkan detail layanan

Layanan histogram dan histogram edge memberikan representasi visual latensi dari sudut pandang layanan atau peminta.

Untuk menafsirkan panel histogram Detail layanan, Anda dapat mencari nilai-nilai yang paling berbeda dari mayoritas nilai dalam histogram. Outlier ini dapat dilihat sebagai puncak atau lonjakan di histogram, dan Anda dapat melihat pelacakan untuk area tertentu untuk menyelidiki apa yang terjadi.

Untuk melihat pelacakan yang difilter menurut latensi, pilih rentang pada histogram. Klik di tempat Anda ingin memulai pemilihan dan seret dari kiri ke kanan untuk menyorot rentang latensi yang akan disertakan dalam filter pelacakan.

Setelah memilih rentang, Anda dapat memilih Perbesar untuk melihat bagian histogram itu dan menyempurnakan pilihan Anda.

Setelah Anda mengatur fokus ke area yang Anda minati, pilih Lihat pelacakan.

AWS X-Ray terus menganalisis data jejak di akun Anda untuk mengidentifikasi masalah yang muncul dalam aplikasi Anda. Ketika tingkat kesalahan melebihi rentang yang diharapkan, itu menciptakan wawasan yang mencatat masalah dan melacak dampaknya hingga diselesaikan. Dengan Wawasan, Anda dapat:

Konsol X-Ray mengidentifikasi node dengan insiden yang sedang berlangsung di peta jejak. Untuk melihat ringkasan wawasan, pilih simpul yang terpengaruh. Anda juga dapat melihat dan memfilter Wawasan dengan memilih Wawasan dari panel navigasi di sebelah kiri.

X-Ray membuat wawasan saat mendeteksi anomali di satu atau beberapa simpul peta layanan. Layanan ini menggunakan pemodelan secara statistik untuk memprediksi tingkat kerusakan yang diharapkan dari layanan dalam aplikasi Anda. Dalam contoh sebelumnya, anomali adalah peningkatan kesalahan dari. AWS Elastic Beanstalk Server Elastic Beanstalk mengalami beberapa timeout panggilan API, menyebabkan anomali di simpul hilir.

Aktifkan Wawasan di konsol X-Ray

Wawasan harus diaktifkan untuk setiap grup tempat Anda ingin menggunakan fitur wawasan. Anda dapat mengaktifkan wawasan dari halaman Grup.

          {
             "Version": "2012-10-17",
             "Statement": [
                 {
                     "Effect": "Allow",
                     "Action": [
                         "xray:GetInsightSummaries",
                         "xray:GetInsight",
                         "xray:GetInsightEvents",
                         "xray:GetInsightImpactGraph"
                     ],
                     "Resource": [
                         "*"
                     ]
                 }
             ]
         }
      

Aktifkan notifikasi wawasan

Dengan notifikasi wawasan, notifikasi dibuat untuk setiap peristiwa wawasan, seperti saat wawasan dibuat, berubah secara signifikan, atau ditutup. Pelanggan dapat menerima pemberitahuan ini melalui EventBridge peristiwa Amazon, dan menggunakan aturan bersyarat untuk mengambil tindakan seperti pemberitahuan SNS, pemanggilan Lambda, memposting pesan ke antrean SQS, atau salah satu target yang mendukung. EventBridge Wawasan notifikasi dipancarkan berdasarkan upaya terbaik - tetapi tidak dijamin. Untuk informasi selengkapnya tentang target, lihat EventBridge Target Amazon.

Anda dapat mengaktifkan notifikasi wawasan untuk setiap grup yang diaktifkan wawasan dari halaman Grup.

Gambaran umum wawasan

Halaman gambaran umum untuk tiga pertanyaan utama yang coba dijawab wawasan:

Bagian Layanan anomali menunjukkan garis waktu untuk setiap layanan yang menggambarkan perubahan tingkat kerusakan selama insiden. Garis waktu menunjukkan jumlah jejak dengan kesalahan yang dilapisi pada pita padat yang menunjukkan jumlah kesalahan yang diharapkan berdasarkan jumlah lalu lintas yang direkam. Durasi wawasan divisualisasikan oleh Jendela insiden. Jendela insiden dimulai saat X-Ray mengamati metrik menjadi anomali dan berlanjut saat wawasan aktif.

Contoh berikut menunjukkan peningkatan kerusakan yang menyebabkan insiden:

Bagian Root cause menunjukkan peta jejak yang difokuskan pada layanan akar penyebab dan jalur yang terkena dampak. Anda dapat menyembunyikan simpul yang tidak terpengaruh dengan memilih ikon mata di kanan atas peta Akar penyebab. Layanan akar penyebab adalah simpul hilir terjauh tempat X-Ray mengidentifikasi anomali. Layanan ini dapat mewakili layanan yang Anda instrumentasikan atau layanan eksternal yang dipanggil oleh layanan Anda dengan klien yang diinstrumentasikan. Misalnya, jika Anda memanggil Amazon DynamoDB dengan klien SDK yang AWS diinstrumentasi, peningkatan kesalahan dari DynamoDB akan menghasilkan wawasan dengan DynamoDB sebagai akar penyebabnya.

Untuk menyelidiki lebih lanjut akar penyebabnya, pilih Lihat detail akar penyebab pada grafik akar penyebab. Anda dapat menggunakan Analitik untuk menyelidiki akar penyebab dan pesan terkait. Untuk informasi selengkapnya, lihat Berinteraksi dengan konsol Analytics.

Kerusakan yang berlanjut ke hulu di dalam peta dapat memengaruhi beberapa simpul dan menyebabkan beberapa anomali. Jika kerusakan diteruskan sepenuhnya ke pengguna yang membuat permintaan, hasilnya adalah kerusakan client. Ini adalah kesalahan pada simpul akar peta jejak. Grafik Dampak menyediakan lini masa pengalaman klien untuk seluruh grup. Pengalaman ini dihitung berdasarkan persentase status berikut: Kerusakan, Kesalahan, Throttle, dan Oke.

Contoh ini menunjukkan peningkatan pelacakan dengan kerusakan pada simpul akar selama waktu insiden. Insiden di layanan hilir tidak selalu sesuai dengan peningkatan kesalahan klien.

Memilih Analisis wawasan akan membuka konsol Analitik X-Ray di jendela tempat Anda dapat menyelami rangkaian pelacakan yang menyebabkan wawasan. Untuk informasi selengkapnya, lihat Berinteraksi dengan konsol Analytics.

Memahami dampak

AWS X-Ray mengukur dampak yang disebabkan oleh masalah yang sedang berlangsung sebagai bagian dari menghasilkan wawasan dan pemberitahuan. Dampaknya diukur dengan dua cara:

Dampak ini ditentukan oleh persentase permintaan yang gagal atau menyebabkan kesalahan dalam jangka waktu tertentu. Analisis dampak ini memungkinkan Anda untuk memperoleh tingkat kepelikan dan prioritas masalah berdasarkan skenario khusus Anda. Dampak ini tersedia sebagai bagian dari pengalaman konsol selain pemberitahuan wawasan.

Deduplikasi

AWS X-Ray wawasan menghilangkan duplikat masalah di beberapa layanan mikro. Ini menggunakan deteksi anomali untuk menentukan layanan yang merupakan akar penyebab masalah, menentukan apakah layanan terkait lainnya menunjukkan perilaku anomali karena akar penyebab yang sama, dan mencatat hasilnya sebagai wawasan tunggal.

Tinjau progres wawasan

X-Ray mengevaluasi kembali wawasan secara berkala hingga diselesaikan, dan mencatat setiap perubahan perantara yang penting sebagai pemberitahuan, yang dapat dikirim sebagai acara Amazon. EventBridge Ini memungkinkan Anda untuk membangun proses dan alur kerja untuk menentukan bagaimana masalah telah berubah dari waktu ke waktu, dan mengambil tindakan yang sesuai seperti mengirim email atau mengintegrasikan dengan sistem peringatan menggunakan. EventBridge

Anda dapat meninjau kejadian peristiwa kejadian di dalam Linimasa Dampak di halaman Inspeksi. Secara default, linimasa menampilkan layanan yang paling terpengaruh hingga Anda memilih layanan yang berbeda.

Untuk melihat peta jejak dan grafik untuk suatu peristiwa, pilih dari timeline dampak. Peta jejak menunjukkan layanan dalam aplikasi Anda yang terpengaruh oleh insiden tersebut. Di bawah Analisis dampak, grafik menunjukkan linimasa kerusakan untuk simpul yang dipilih dan untuk klien dalam grup.

Untuk melihat lebih dalam pelacakan yang terlibat dalam insiden, pilih Analisis peristiwa di halaman Inspeksi. Anda dapat menggunakan halaman Analitik untuk memfilter daftar pelacakan dan mengidentifikasi pengguna yang terpengaruh. Untuk informasi selengkapnya, lihat Berinteraksi dengan konsol Analytics.

Konsol AWS X-Ray Analytics adalah alat interaktif untuk menafsirkan data jejak agar dapat dengan cepat memahami kinerja aplikasi Anda dan layanan yang mendasarinya. Konsol ini memungkinkan Anda untuk mengeksplorasi, menganalisis, dan memvisualisasikan pelacakan melalui waktu respons interaktif dan grafik deret waktu.

Saat membuat pilihan di konsol Analitik, konsol tersebut membuat filter untuk mencerminkan subset yang dipilih dari semua pelacakan. Anda dapat mempersempit set data aktif dengan meningkatkan filter terperinci dengan mengeklik grafik dan panel metrik dan bidang yang terkait dengan set pelacakan saat ini.

Konsol Analitik X-Ray menggunakan fitur kunci berikut untuk mengelompokkan, memfilter, membandingkan, dan mengukur data pelacakan.

Fitur

Fitur	Deskripsi
Grup	Grup yang dipilih di awal adalah Default. Untuk mengubah grup yang diambil, pilih grup yang berbeda dari menu di sebelah kanan bilah pencarian ekspresi filter utama. Untuk mempelajari selengkapnya tentang grup, lihat Mengonfigurasi grup.
Jejak yang diambil	Secara default, konsol Analitik menghasilkan grafik berdasarkan semua pelacakan dalam grup yang dipilih. Pelacakan yang diambil mewakili semua pelacakan di set kerja Anda. Anda dapat mencari jumlah pelacakan di file ini. Filter ekspresi yang Anda terapkan ke bilah pencarian utama mempersempit dan memperbarui pelacakan yang diambil.
Tampilkan di bagan/Sembunyikan dari grafik	Beralih untuk membandingkan grup aktif terhadap pelacakan yang diambil. Untuk membandingkan data terkait grup dengan filter aktif apa pun, pilih Tampilkan dalam bagan. Untuk menghilangkan tampilan ini dari bagan, pilih Sembunyikan dari bagan.
Jejak yang difilter set A	Melalui interaksi dengan grafik dan tabel, terapkan filter untuk membuat kriteria untuk Set pelacakan yang difilter. Ketika filter diterapkan, jumlah pelacakan yang berlaku dan persentase pelacakan dari total yang diambil dihitung dalam file ini. Filter diisi sebagai tanda dalam ubin Set pelacakan A yang difilter dan juga dapat dihapus dari ubin.
Sempurnakan	Fungsi ini memperbarui set pelacakan yang diambil berdasarkan filter yang diterapkan untuk melacak set A. Penyempitan set pelacakan yang diambil menyegarkan set pekerjaan dari semua pelacakan yang diambil berdasarkan filter untuk set pelacakan A. set kerja pelacakan yang diambil adalah subset sampel dari semua pelacakan dalam grup.
Set jejak yang difilter B	Saat dibuat, kumpulan jejak yang difilter B adalah salinan dari Jejak yang difilter set A. Untuk membandingkan dua set jejak, buat pilihan filter baru yang akan berlaku untuk melacak set B, sementara trace set A tetap diperbaiki. Ketika filter diterapkan, jumlah pelacakan yang berlaku dan persentase pelacakan dari total yang diambil dihitung dalam ubin ini. Filter diisi sebagai tanda dalam ubin Set pelacakan B yang difilter dan juga dapat dihapus dari ubin.
Jalur entitas akar penyebab waktu respons	Sebuah tabel jalur entitas yang dicatat. X-Ray menentukan jalur di pelacakan Anda yang merupakan penyebab yang paling memungkinkan untuk waktu respons. Format menunjukkan hierarki entitas yang ditemui, berakhir dengan akar masalah waktu respons. Gunakan baris ini untuk memfilter kesalahan waktu respons berulang. Untuk informasi selengkapnya tentang menyesuaikan filter akar penyebab dan mendapatkan data melalui API, lihat bagian Mengambil dan menyempurnakan analisis akar penyebab di. Mendapatkan data dari X-Ray
Delta ()	Kolom yang ditambahkan ke tabel metrik ketika kedua set pelacakan A dan set pelacakan B aktif. Kolom Delta menghitung selisih dalam persentase pelacakan antara pelacakan antara set pelacakan A dan set pelacakan B.

Konsol Analitik X-Ray menghasilkan dua grafik utama untuk membantu Anda memvisualisasikan pelacakan: Distribusi Waktu Respons dan Aktivitas Deret Waktu. Bagian ini dan berikut ini memberikan contoh masing-masing, dan menjelaskan dasar-dasar cara membaca grafik.

Berikut ini adalah warna yang terkait dengan grafik garis waktu respons (grafik deret waktu menggunakan skema warna yang sama):

• Semua pelacakan dalam grup – abu-abu

• Pelacakan yang diambil – oranye

• Set pelacakan A yang difilter – hijau

• Set pelacakan B yang difilter – biru

contoh – Distribusi waktu respons

Distribusi waktu respons adalah bagan yang menunjukkan jumlah pelacakan dengan waktu respons yang diberikan. Klik dan seret untuk membuat pilihan dalam distribusi waktu respons. Hal ini memilih dan membuat filter pada set pelacakan kerja bernama responseTime untuk semua pelacakan dalam waktu respons tertentu.

Bagan aktivitas deret waktu menunjukkan jumlah pelacakan pada periode waktu tertentu. Indikator warna mencerminkan warna grafik garis dari distribusi waktu respons. Semakin gelap dan penuh blok warna dalam rangkaian aktivitas, semakin banyak pelacakan yang ditunjukkan pada waktu tertentu.

contoh – Aktivitas deret waktu

Klik dan seret untuk membuat pilihan dalam grafik aktivitas deret waktu. Hal ini memilih dan membuat filter bernama timerange pada set pelacakan kerja untuk semua pelacakan dalam kisaran waktu tertentu.

Contoh berikut menunjukkan kasus penggunaan umum untuk konsol Analitik X-Ray. Setiap contoh menunjukkan fungsi kunci dari pengalaman konsol tersebut. Sebagai grup, contoh mengikuti alur kerja pemecahan masalah dasar. Langkah-langkah tersebu menjelaskan cara pertama menemukan simpul yang tidak sehat, lalu cara berinteraksi dengan konsol Analitik untuk secara otomatis menghasilkan kueri komparatif. Setelah Anda mempersempit ruang lingkup melalui kueri, Anda akhirnya akan melihat detail pelacakan yang menarik untuk menentukan apa yang kondisi layanan Anda.

Peta jejak menunjukkan kesehatan setiap node dengan mewarnai berdasarkan rasio panggilan yang berhasil terhadap kesalahan dan kesalahan. Ketika persentase merah terlihat pada simpul Anda, warna tersebut menandakan adanya kerusakan. Gunakan konsol Analitik X-Ray untuk menyelidikinya.

Untuk informasi selengkapnya tentang cara membaca peta jejak, lihat Menggunakan peta jejak X-Ray.

Menggunakan distribusi waktu respons, Anda dapat mengamati puncak dalam waktu respons. Dengan memilih puncak dalam waktu respons, tabel di bawah grafik akan diperbarui untuk mengekspos semua metrik terkait, seperti kode status.

Saat Anda mengeklik dan menyeret, X-Ray akan memilih dan membuat filter. Ini ditampilkan dalam bayangan abu-abu di atas garis grafik. Sekarang Anda dapat menyeret bayangan tersebut ke kiri dan kanan sepanjang distribusi untuk memperbarui pilihan dan filter Anda.

Anda dapat menelusuri pelacakan dalam puncak yang dipilih menggunakan tabel metrik di bawah grafik. Dengan mengeklik baris di tabel KODE STATUS HTTP, Anda secara otomatis membuat filter pada set data bekerja. Misalnya, Anda dapat melihat semua pelacakan kode status 500. Hal ini menciptakan tanda filter di ubin set pelacakan bernama http.status.

Telusuri set kesalahan berdasarkan pengguna, URL, akar masalah waktu respons, atau atribut lain yang ditentuka sebelumnya. Misalnya, untuk memfilter set pelacakan dengan kode status 500, pilih baris dari tabel PENGGUNA. Hal ini menyebabkan dua tanda filter di ubin set pelacakan: http.status, seperti yang ditetapkan sebelumnya, dan user.

Bandingkan berbagai pengguna dengan permintaan POST mereka untuk menemukan perbedaan dan korelasi lainnya. Terapkan set filter pertama Anda. Set filter ditentukan berdasarkan garis biru dalam distribusi waktu respons. Kemudian pilih Bandingkan. Awalnya, ini hal ini membuat salinan filter pada set pelacakan set A.

Untuk melanjutkan, tentukan satu set filter baru untuk diterapkan pada set pelacakan B. set kedua ini diwakili oleh garis hijau. Contoh berikut menunjukkan garis yang berbeda berdasarkan skema warna biru dan hijau.

Saat Anda mempersempit cakupan Anda menggunakan filter konsol tersebut, daftar pelacakan di bawah tabel metrik menjadi lebih bermakna. Tabel daftar pelacakan menggabungkan informasi tentang URL, PENGGUNA, dan KODE STATUS menjadi satu tampilan. Untuk wawasan lebih lanjut, pilih baris dari tabel ini untuk membuka halaman detail pelacakan dan lihat lini masa dan data mentah.

Grup adalah kumpulan pelacakan yang ditentukan oleh ekspresi filter. Anda dapat menggunakan grup untuk menghasilkan grafik layanan tambahan dan menyediakan CloudWatch metrik Amazon. Anda dapat menggunakan konsol AWS X-Ray tersebut atau API X-Ray untuk membuat dan mengelola grup untuk layanan Anda. Topik ini menjelaskan cara membuat dan mengelola grup menggunakan konsol X-Ray. Untuk informasi tentang cara mengelola grup dengan menggunakan API X-Ray, lihat Mengkonfigurasi pengaturan sampling, grup, dan enkripsi dengan X-Ray API.

Anda dapat membuat grup jejak untuk peta jejak, jejak, atau analitik. Saat Anda membuat grup, grup akan tersedia sebagai filter pada menu tarik-turun grup di ketiga halaman: Trace Map, Traces, dan Analytics.

Grup diidentifikasi oleh nama mereka atau Amazon Resource Name (ARN), dan berisi ekspresi filter. Layanan ini membandingkan pelacakan masuk ke ekspresi dan menyimpannya dengan sesuai. Untuk informasi selengkapnya tentang cara membangun ekspresi filter, lihat Gunakan ekspresi filter.

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 hal tersebut, hapus grup saat ini dan buat yang baru.

Membuat grup

Terapkan grup

Mengedit grup

Klon grup

Meng-klon grup membuat grup baru yang memiliki ekspresi filter dan tanda dari grup yang ada. Ketika Anda meng-klon grup, grup baru yang memiliki nama yang sama dengan grup yang di-klon, dengan -clone ditambahkan ke nama.

Menghapus grup

Ikuti langkah-langkah di bagian ini untuk menghapus grup. Anda tidak dapat menghapus grup Default.

Lihat metrik grup di Amazon CloudWatch

Setelah grup dibuat, pelacakan masuk diperiksa terhadap ekspresi filter grup saat disimpan di layanan X-Ray. Metrik untuk jumlah jejak yang cocok dengan setiap kriteria dipublikasikan ke Amazon CloudWatch setiap menit. Memilih Lihat metrik pada halaman Edit grup membuka CloudWatch konsol ke halaman Metrik. Untuk informasi selengkapnya tentang cara menggunakan CloudWatch metrik, lihat Menggunakan CloudWatch Metrik Amazon di CloudWatch Panduan Pengguna Amazon.

Anda dapat menggunakan AWS X-Ray konsol untuk mengonfigurasi aturan pengambilan sampel untuk layanan Anda. X-Ray SDK dan Layanan AWS yang mendukung penelusuran aktif dengan konfigurasi sampling menggunakan aturan pengambilan sampel untuk menentukan permintaan mana yang akan direkam.

Konfigurasikan aturan pengambilan sampel

Anda dapat mengonfigurasi pengambilan sampel untuk kasus penggunaan berikut ini:

Menyesuaikan aturan pengambilan sampel

Dengan menyesuaikan aturan pengambilan sampel, Anda dapat mengontrol jumlah data yang Anda rekam. Anda juga dapat 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 mencatat permintaan pertama yang diterima pada awal setiap detik, dan lima persen dari permintaan tambahan apa pun. Satu permintaan per detik adalah reservoir. Tindakan ini memastikan bahwa setidaknya satu pelacakan dicatat setiap detik selama layanan melayani permintaan. Lima persen adalah tingkat saat permintaan tambahan di luar ukuran reservoir diambil sampelnya.

Anda dapat mengonfigurasi SDK X-Ray untuk membaca aturan pengambilan sampel dari dokumen JSON yang Anda sertakan dengan kode Anda. Namun, saat Anda menjalankan beberapa instans layanan Anda, setiap instans melakukan pengambilan sampel secara independen. Hal ini menyebabkan persentase keseluruhan permintaan sampel meningkat karena reservoir dari semua instans secara efektif ditambahkan bersama-sama. Selain itu, untuk memperbarui aturan pengambilan sampel lokal, Anda harus menerapkan ulang kode Anda.

Dengan menetapkan aturan pengambilan sampel di konsol X-Ray, dan mengonfigurasi SDK untuk membaca aturan dari layanan X-Ray, Anda dapat menghindari kedua masalah ini. Layanan mengelola reservoir untuk setiap aturan, dan menetapkan kuota ke setiap instans layanan Anda untuk mendistribusikan reservoir secara merata, berdasarkan jumlah instans yang berjalan. Batas reservoir dihitung sesuai dengan aturan yang Anda tetapkan. Karena aturan dikonfigurasi dalam layanan, Anda dapat mengelola aturan tanpa membuat penerapan tambahan. Untuk informasi selengkapnya tentang AWS SDK, lihat Menggunakan SDK.

Anda sekarang dapat mengonfigurasi aturan pengambilan sampel X-Ray dari dalam CloudWatch konsol Amazon. Anda juga dapat terus menggunakan konsol X-Ray.

Opsi aturan pengambilan sampel

Opsi berikut tersedia untuk setiap aturan. Nilai string dapat menggunakan wildcard untuk mencocokkan satu karakter (?) atau nol atau beberapa karakter (*).

Contoh aturan pengambilan sampel

Konfigurasikan layanan Anda untuk menggunakan aturan pengambilan sampel

SDK X-Ray memerlukan konfigurasi tambahan untuk menggunakan aturan pengambilan sampel yang Anda konfigurasikan di konsol. Lihat topik konfigurasi untuk bahasa Anda untuk detail tentang mengonfigurasi strategi pengambilan sampel:

Untuk API Gateway, lihat Dukungan penelusuran aktif Amazon API Gateway untuk AWS X-Ray.

Melihat hasil pengambilan sampel

Halaman Pengambilan sampel konsol X-Ray menampilkan informasi mendetail tentang cara layanan Anda menggunakan setiap aturan pengambilan sampel.

Kolom Tren menunjukkan cara aturan telah digunakan dalam beberapa menit terakhir. Setiap kolom menunjukkan statistik untuk jendela 10 detik.

Untuk informasi selengkapnya tentang statistik pengambilan sampel dan cara layanan menggunakan aturan pengambilan sampel, lihat Penggunaan aturan pengambilan sampel dengan API X-Ray.

Langkah selanjutnya

Anda dapat menggunakan API X-Ray untuk mengelola aturan pengambilan sampel. Dengan API, Anda dapat membuat dan memperbarui aturan secara terprogram sesuai jadwal, atau sebagai respons terhadap alarm atau notifikasi. Lihat Mengkonfigurasi pengaturan sampling, grup, dan enkripsi dengan X-Ray API untuk instruksi dan contoh aturan tambahan.

X-Ray SDK dan Layanan AWS juga menggunakan X-Ray API untuk membaca aturan sampling, melaporkan hasil sampling, dan mendapatkan target sampling. Layanan harus melacak intensitas layanan dalam menerapkan setiap aturan, mengevaluasi aturan berdasarkan prioritas, dan meminjam dari reservoir saat permintaan cocok dengan aturan ketika X-Ray belum menetapkan kuota layanan. Untuk detail selengkapnya tentang cara layanan menggunakan API untuk pengambilan sampel, lihatPenggunaan aturan pengambilan sampel dengan API X-Ray.

Saat SDK X-Ray memanggil API pengambilan sampel, SDK X-Ray menggunakan daemon X-Ray sebagai proksi. Jika Anda sudah menggunakan TCP port 2000, Anda dapat mengonfigurasi daemon untuk menjalankan proksi pada port yang berbeda. Lihat Mengkonfigurasi daemon AWS X-Ray untuk detail.

Anda dapat menggunakan rute dan kueri untuk menautkan jauh ke jejak tertentu, atau tampilan jejak dan peta jejak yang difilter.

Pelacakan

Anda dapat membuat tautan untuk timeline, raw, dan peta tampilan pelacakan individu.

Lacak timeline – xray/home#/traces/trace-id

Data pelacakan mentah – xray/home#/traces/trace-id/raw

https://console.aws.amazon.com/xray/home#/traces/1-57f5498f-d91047849216d0f2ea3b6442/raw

Ekspresi Filter

Tautan ke daftar pelacakan yang difilter.

Tampilan pelacakan yang difilter – xray/home#/traces?filter=filter-expression

https://console.aws.amazon.com/xray/home#/traces?filter=service("api.amazon.com") { fault = true OR responsetime > 2.5 } AND annotation.foo = "bar"

https://console.aws.amazon.com/xray/home#/traces?filter=service(%22api.amazon.com%22)%20%7B%20fault%20%3D%20true%20OR%20responsetime%20%3E%202.5%20%7D%20AND%20annotation.foo%20%3D%20%22bar%22

Untuk informasi selengkapnya tentang ekspresi filter, lihat Gunakan ekspresi filter.

Rentang waktu

Tentukan lama waktu atau waktu mulai dan akhir dalam format ISO8601. Rentang waktu berada dalam UTC dan dapat mencapai 6 jam.

Lamanya waktu – xray/home#/page?timeRange=range-in-minutes

https://console.aws.amazon.com/xray/home#/service-map?timeRange=PT1H

Waktu mulai dan akhir – xray/home#/page?timeRange=start~end

https://console.aws.amazon.com/xray/home#/traces?timeRange=2023-7-01T16:00:00~2023-7-01T22:00:00

https://console.aws.amazon.com/xray/home#/traces?timeRange=2023-7-01T16:00~2023-7-01T22:00

Wilayah

Tentukan tautan Wilayah AWS ke halaman di Wilayah itu. Jika Anda tidak menentukan Wilayah, konsol tersebut akan mengalihkan Anda ke Wilayah terakhir yang dikunjungi.

Wilayah — xray/home?region=region#/page

https://console.aws.amazon.com/xray/home?region=us-west-2#/service-map

Bila Anda menyertakan Wilayah dengan parameter kueri lainnya, kueri Wilayah diteruskan sebelum hash, dan kueri X-Ray tertentu diteruskan setelah nama halaman.

https://console.aws.amazon.com/xray/home?region=us-west-2#/service-map?timeRange=PT1H

Gabungan

https://console.aws.amazon.com/xray/home#/traces?timeRange=PT15M&filter=duration%20%3E%3D%205%20AND%20duration%20%3C%3D%208