Menggunakan PromQL di alarm

Anda dapat membuat CloudWatch alarm yang menggunakan kueri PromQL untuk memantau metrik Anda. Alarm PromQL mengevaluasi ekspresi promQL dan memicu perubahan status alarm berdasarkan hasil kueri.

Untuk informasi tentang konsep alarm, lihatKonsep.

Untuk informasi tentang kueri data alarm, lihatKueri data alarm.

Untuk informasi tentang tindakan alarm, lihatTindakan-tindakan alarm.

Untuk informasi tentang batas alarm, lihatBatas.

Membuat alarm PromQL

Anda dapat membuat alarm PromQL dari CloudWatch konsol, file AWS CLI, atau API. CloudWatch

Untuk membuat alarm PromQL dari konsol

1. Buka konsol CloudWatch .

2. Pada panel navigasi, pilih Alarm, Semua alarm.

3. Pilih Buat alarm.

4. Pilih Pilih metrik, lalu pilih tab PromQL.

5. Masukkan kueri PromQL Anda. Kueri harus mengembalikan satu deret waktu agar alarm dapat dievaluasi.

6. Konfigurasikan kondisi alarm, termasuk ambang batas, periode evaluasi, dan titik data ke alarm.

7. Konfigurasikan tindakan alarm, seperti notifikasi Amazon SNS.

8. Masukkan nama dan deskripsi untuk alarm, lalu pilih Buat alarm.

Anda juga dapat membuat alarm PromQL langsung dari Menjalankan kueri PromQL di Query Studio (Pratinjau) setelah menjalankan kueri yang mengembalikan satu deret waktu.

Membuat CloudWatch alarm menggunakan PromQL untuk deteksi anomali

Anda dapat membuat alarm PromQL yang memicu ketika metrik melanggar rentang yang diharapkan yang ditentukan oleh batas statistik. Kueri alarm menggabungkan batas atas dan bawah menjadi satu ekspresi yang hanya mengembalikan titik data anomali. Setiap deret waktu yang dikembalikan oleh kueri dianggap melanggar.

Contoh ekspresi berikut mendeteksi bila metrik permintaan iklan melebihi 3 standar deviasi dari median selama 60 menit:

1 * {"app.ads.ad_requests"} > quantile_over_time(0.5, {"app.ads.ad_requests"}[60m] offset 1m)
    + 3 * stddev_over_time({"app.ads.ad_requests"}[60m] offset 1m)
or
1 * {"app.ads.ad_requests"} < clamp_min(
    quantile_over_time(0.5, {"app.ads.ad_requests"}[60m] offset 1m)
    - 3 * stddev_over_time({"app.ads.ad_requests"}[60m] offset 1m),
0)

Ekspresi ini bekerja di beberapa nilai label, sehingga alarm dapat melacak anomali di seluruh armada Anda. Setiap deret waktu pelanggaran dilacak sebagai kontributor terpisah. Untuk informasi selengkapnya tentang cara alarm PromQL mengevaluasi kontributor, lihat. Alarm PromQL

Anda dapat menyesuaikan pengganda dan jendela waktu agar sesuai dengan perilaku metrik Anda. Pengganda yang lebih tinggi menghasilkan batas yang lebih luas dengan lebih sedikit positif palsu. Jendela waktu yang lebih lama menghaluskan lonjakan jangka pendek. clamp_minFungsi ini mencegah batas bawah menjadi negatif untuk metrik yang tidak dapat memiliki nilai negatif.

Untuk informasi lebih lanjut tentang membangun pita deteksi anomali dengan PromQL, lihat. Deteksi anomali menggunakan PromQL