Mengonfigurasi aturan pengambilan sampel - AWS X-Ray
Mengonfigurasi aturan pengambilan sampelMenyesuaikan aturan pengambilan sampelOpsi aturan pengambilan sampelContoh aturan pengambilan sampelMengonfigurasi layanan Anda untuk menggunakan aturan pengambilan sampelMelihat hasil pengambilan sampelLangkah selanjutnya

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

Mengonfigurasi aturan pengambilan sampel

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.

Mengonfigurasi aturan pengambilan sampel

Anda dapat mengonfigurasi pengambilan sampel untuk kasus penggunaan berikut ini:

  • Titik Masuk API Gateway – API Gateway mendukung pengambilan sampel dan pelacakan aktif. Untuk mengaktifkan pelacakan aktif pada tahap API, lihat Dukungan penelusuran aktif Amazon API Gateway untuk AWS X-Ray.

  • AWS AppSync— AWS AppSync mendukung pengambilan sampel dan penelusuran aktif. Untuk mengaktifkan penelusuran aktif pada AWS AppSync permintaan, lihat Menelusuri dengan AWS X-Ray.

  • Instrumen X-Ray SDK pada platform komputasi — Saat menggunakan platform komputasi seperti Amazon EC2, Amazon ECS, atau AWS Elastic Beanstalk, sampling didukung saat aplikasi telah diinstrumentasi dengan SDK X-Ray terbaru.

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, SDK X-Ray mencatat 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 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.

catatan

X-Ray menggunakan pendekatan upaya terbaik dalam menerapkan aturan pengambilan sampel, dan dalam beberapa kasus laju pengambilan sampel efektif mungkin tidak sama persis dengan aturan pengambilan sampel yang dikonfigurasi. Namun, seiring waktu jumlah permintaan sampel harus mendekati persentase yang dikonfigurasi.

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

CloudWatch console
Untuk mengonfigurasi aturan pengambilan sampel di konsol CloudWatch

  1. Masuk ke AWS Management Console dan buka CloudWatch konsol di https://console.aws.amazon.com/cloudwatch/.

  2. Pilih Pengaturan di panel navigasi kiri.

  3. Pilih Lihat pengaturan di bawah Aturan pengambilan sampel dalam bagian jejak X-Ray.

  4. Untuk membuat aturan, pilih Buat aturan pengambilan sampel.

    Untuk mengedit aturan, pilih aturan dan pilih Edit untuk mengeditnya.

    Untuk menghapus aturan, pilih aturan dan pilih Hapus untuk menghapusnya.

X-Ray console
Untuk mengonfigurasi aturan pengambilan sampel di konsol X-Ray

  1. Buka Konsol X-Ray.

  2. Pilih Sampling di panel navigasi kiri.

  3. Untuk membuat aturan, pilih Buat aturan pengambilan sampel.

    Untuk mengedit aturan, pilih nama aturan.

    Untuk menghapus aturan, pilih aturan dan gunakan menu Tindakan untuk menghapusnya.

Opsi aturan pengambilan sampel

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

Opsi aturan pengambilan sampel

  • Nama aturan (string) - Sebuah nama unik untuk aturan tersebut.

  • Prioritas (bilangan bulat antara 1 hingga 9999) - Prioritas aturan pengambilan sampel. Layanan mengevaluasi aturan dalam urutan prioritas naik, dan membuat keputusan pengambilan sampel dengan aturan pertama yang cocok.

  • Reservoir (bilangan bulat bukan negatif) – Jumlah tetap permintaan yang cocok dengan instrumen per detik, sebelum menerapkan tingkat tetap. Reservoir tidak digunakan secara langsung oleh layanan, tetapi berlaku untuk semua layanan yang menggunakan aturan secara kolektif.

  • Tingkat (bilangan bulat antara 0 dan 100) — Persentase permintaan yang cocok dengan instrumen, setelah reservoir habis. Saat mengonfigurasi aturan pengambilan sampel di konsol, pilih persentase antara 0 dan 100. Saat mengonfigurasi aturan pengambilan sampel dalam SDK klien menggunakan dokumen JSON, berikan nilai persentase antara 0 dan 1.

  • Nama layanan (string) — Nama layanan instrumentasi, seperti yang muncul di peta jejak.

    • SDK X-Ray – Nama layanan yang Anda konfigurasikan pada pencatat.

    • Amazon API Gateway – api-name/stage.

  • Jenis layanan (string) - Jenis layanan, seperti yang muncul di peta jejak. Untuk SDK X-Ray, atur tipe layanan dengan menerapkan plugin yang sesuai:

    • AWS::ElasticBeanstalk::Environment— AWS Elastic Beanstalk Lingkungan (plugin).

    • AWS::EC2::Instance – Sebuah instans Amazon EC2 (plugin).

    • AWS::ECS::Container – Sebuah kontainer Amazon ECS (plugin).

    • AWS::APIGateway::Stage – Sebuah tahap Amazon API Gateway.

    • AWS::AppSync::GraphQLAPI — Permintaan AWS AppSync API.

  • Host (string) – Nama host dari header host HTTP.

  • Metode HTTP (string) – Metode permintaan HTTP.

  • Jalur URL (string) – Jalur URL permintaan.

    • SDK X-Ray – Bagian jalur dari URL permintaan HTTP.

  • Resource ARN (string) — ARN AWS sumber daya yang menjalankan layanan.

    • SDK X-Ray – Tidak didukung. SDK hanya dapat menggunakan aturan dengan ARN Sumber Daya diatur ke *.

    • Amazon API Gateway – ARN tahap.

  • (Opsional) Atribut (kunci dan nilai) – Atribut segmen yang diketahui ketika keputusan pengambilan sampel dibuat.

    • SDK X-Ray – Tidak didukung. SDK mengabaikan aturan yang menentukan atribut.

    • Amazon API Gateway – Header dari permintaan HTTP asli.

Contoh aturan pengambilan sampel

contoh – Aturan default tanpa reservoir dan tingkat rendah

Anda dapat mengubah reservoir dan tingkat aturan default. Aturan default berlaku untuk permintaan yang tidak cocok dengan aturan lainnya.

  • Reservoir: 0

  • Nilai: 5 (0.05jika dikonfigurasi menggunakan dokumen JSON)

contoh – Aturan men-debug untuk melacak semua permintaan untuk rute yang bermasalah

Aturan prioritas tinggi diterapkan sementara untuk men-debug.

  • Nama aturan: DEBUG – history updates

  • Prioritas: 1

  • Reservoir: 1

  • Nilai: 100 (1jika dikonfigurasi menggunakan dokumen JSON)

  • Nama layanan: Scorekeep

  • Tipe layanan: *

  • Tuan rumah: *

  • Metode HTTP: PUT

  • Jalur URL: /history/*

  • Sumber daya ARN: *

contoh – Tingkat minimum lebih tinggi untuk POST

  • Nama aturan: POST minimum

  • Prioritas: 100

  • Reservoir: 10

  • Nilai: 10 (.1jika dikonfigurasi menggunakan dokumen JSON)

  • Nama layanan: *

  • Tipe layanan: *

  • Tuan rumah: *

  • Metode HTTP: POST

  • Jalur URL: *

  • Sumber daya ARN: *

Mengonfigurasi 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.

Statistik pengambilan sampel

  • Total aturan yang cocok: Jumlah permintaan yang cocok dengan aturan ini. Jumlah ini tidak termasuk permintaan yang mungkin cocok dengan aturan ini, tetapi cocok dengan aturan dengan prioritas lebih tinggi terlebih dahulu.

  • Total sampel: Jumlah permintaan yang direkam.

  • Sampel dengan tarif tetap: Jumlah permintaan yang diambil sampelnya dengan menerapkan tarif tetap aturan.

  • Sampel dengan batas reservoir: Jumlah permintaan sampel menggunakan kuota yang ditetapkan oleh X-Ray.

  • Dipinjam dari waduk: Jumlah permintaan yang diambil sampelnya dengan meminjam dari reservoir. Saat pertama kali layanan mencocokkan permintaan dengan aturan, kuota belum ditetapkan oleh X-Ray. Namun, jika reservoir setidaknya 1, layanan meminjam satu pelacakan per detik hingga X-Ray menetapkan kuota.

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 Mengonfigurasi pengambilan sampel, grup, dan pengaturan enkripsi denganAWS X-RayAPI 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, lihat Penggunaan 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 rincian selengkapnya.