Buat alarm menggunakan kueri PromQL - Amazon CloudWatch
Membuat alarm PromQL menggunakan Konsol Manajemen AWSMembuat alarm PromQL ()AWS CLIMembuat alarm PromQL dari Query Studio

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

Buat alarm menggunakan kueri PromQL

Anda dapat membuat CloudWatch alarm yang menggunakan kueri instan PromQL untuk memantau metrik yang dicerna melalui titik akhir OTLP. CloudWatch Semua deret waktu yang cocok yang dikembalikan oleh kueri dianggap melanggar, dan alarm melacak setiap deret waktu yang melanggar sebagai kontributor. Untuk informasi selengkapnya tentang cara kerja alarm PromQL, lihat. Alarm PromQL

Membuat alarm PromQL menggunakan Konsol Manajemen AWS

Contoh ini menunjukkan cara membuat alarm yang memantau metrik pengukur dan memberi tahu Anda saat nilainya turun di bawah 20.

Untuk membuat alarm PromQL

  1. Buka CloudWatch konsol di https://console.aws.amazon.com/cloudwatch/.

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

  3. Pilih Buat alarm.

  4. Pilih PromQL untuk jenis metrik.

  5. Dalam mode Editor, masukkan kueri PromQL:

    my_gauge_metric < 20

  6. Pada Ketentuan, tentukan hal-hal berikut:

    • Untuk interval Evaluasi, pilih1 minute, untuk menentukan seberapa sering kueri PromQL dievaluasi.

    • Untuk periode Tertunda120, masukkan, durasi dalam detik kontributor harus melanggar sebelum memasuki status ALARM.

    • Untuk periode Pemulihan, masukkan300, durasi dalam detik kontributor tidak boleh melanggar sebelum memasuki status OK.

  7. Konfigurasikan pemberitahuan dan tindakan sesuai kebutuhan.

  8. Tambahkan nama dan deskripsi untuk alarm Anda.

  9. Pilih Berikutnya.

  10. Pilih Buat alarm.

Membuat alarm PromQL ()AWS CLI

Gunakan tindakan PutMetricAlarmAPI untuk membuat alarm PromQL.

contoh Buat alarm PromQL yang memicu ketika metrik pengukur turun di bawah 20
aws cloudwatch put-metric-alarm \
  --alarm-name MyPromQLAlarm \
  --evaluation-criteria '{"PromQLCriteria":{"Query":"my_gauge_metric < 20"}}' \
  --evaluation-interval 60
contoh Buat alarm PromQL dengan periode tertunda

Alarm ini menunggu 300 detik (5 menit) sebelum beralih ke ALARM status, dan menunggu 600 detik (10 menit) sebelum pulih.

aws cloudwatch put-metric-alarm \
  --alarm-name HighLatencyAlarm \
  --evaluation-criteria '{"PromQLCriteria":{"Query":"histogram_quantile(0.99, rate(http_request_duration_seconds_bucket[5m])) > 0.5","PendingPeriod":300,"RecoveryPeriod":600}}' \
  --evaluation-interval 60
contoh Buat alarm PromQL dengan tindakan notifikasi SNS
aws cloudwatch put-metric-alarm \
  --alarm-name MyPromQLAlarmWithAction \
  --evaluation-criteria '{"PromQLCriteria":{"Query":"my_gauge_metric < 20","PendingPeriod":0,"RecoveryPeriod":0}}' \
  --evaluation-interval 60 \
  --alarm-actions arn:aws:sns:us-east-1:123456789012:MyTopic

Membuat alarm PromQL dari Query Studio

Contoh ini menunjukkan cara membuat alarm PromQL dari Query Studio yang memberi tahu Anda ketika durasi permintaan HTTP rata-rata untuk layanan melebihi 500 milidetik.

Tidak seperti CloudWatch alarm standar di mana ambang batas dikonfigurasi sebagai langkah terpisah, alarm PromQL mendefinisikan kondisi alarm (ambang batas) sebagai bagian dari kueri itu sendiri. Misalnya, operator perbandingan (>) dan nilai ambang (0.5) disematkan langsung dalam ekspresi promQL.

Untuk membuat alarm PromQL dari Query Studio

  1. Buka CloudWatch konsol di https://console.aws.amazon.com/cloudwatch/.

  2. Di panel navigasi di bawah Metrik, pilih Query Studio (Pratinjau).

  3. Pilih PromQL dari menu drop-down bahasa query.

  4. Buat kueri Anda menggunakan salah satu mode berikut:

    • Dalam mode Builder, pilih nama metrik dari bidang Metrik (misalnya,http.server.request.duration). Tambahkan filter label sesuai kebutuhan (misalnya, @resource.service.name =my-api). Untuk menentukan ambang alarm, pilih Operasi Dasar (misalnya,>) dan masukkan Nomor (misalnya,0.5).

    • Dalam mode Kode, masukkan ekspresi PromQL secara langsung, misalnya:

      histogram_avg({"http.server.request.duration", "@resource.service.name"="my-api"}) > 0.5

  5. Pilih Jalankan untuk mengeksekusi kueri dan memverifikasinya mengembalikan hasil yang diharapkan.

  6. Pilih Buat alarm dari menu tindakan.

  7. Anda diarahkan ke halaman pembuatan CloudWatch alarm dengan kueri PromQL Anda sudah diisi sebelumnya.

  8. Pada Ketentuan, tentukan hal-hal berikut:

    • Untuk interval Evaluasi, pilih1 minute, untuk menentukan seberapa sering kueri PromQL dievaluasi.

    • Untuk periode Tertunda60, masukkan, durasi dalam detik kueri harus dilanggar sebelum memasuki status ALARM. Ini berarti latensi harus melebihi ambang batas setidaknya 60 detik sebelum alarm menyala.

    • Untuk periode Pemulihan, masukkan120, durasi dalam detik kueri tidak boleh dilanggar sebelum memasuki status OK. Ini berarti latensi harus tetap di bawah ambang batas setidaknya selama 120 detik sebelum alarm pulih.

  9. Konfigurasikan pemberitahuan dan tindakan sesuai kebutuhan.

  10. Tambahkan nama dan deskripsi untuk alarm Anda.

  11. Pilih Berikutnya.

  12. Pilih Buat alarm.

catatan

Query PromQL harus mengembalikan satu deret waktu untuk membuat alarm. Jika kueri Anda mengembalikan beberapa deret waktu, gunakan fungsi agregasi seperti sumavg,, atau topk untuk mengurangi hasilnya menjadi satu seri sebelum membuat alarm.