Membuat kebijakan pemberitahuan dengan kondisi berbasis PromQL (Konsol)

Halaman ini menjelaskan cara membuat kebijakan pemberitahuan dengan kondisi berbasis PromQL menggunakan konsol Google Cloud.

Sebelum memulai

1. Untuk mendapatkan izin yang diperlukan guna membuat kebijakan pemberitahuan dengan kondisi berbasis PromQL di konsol Google Cloud, minta administrator untuk memberi Anda peran IAM Monitoring Editor (roles/monitoring.editor) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

   Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

   Untuk informasi selengkapnya tentang peran Cloud Monitoring, lihat Mengontrol akses dengan Identity and Access Management.

2. Pastikan Anda memahami konsep umum kebijakan pemberitahuan dan PromQL di Cloud Monitoring. Untuk informasi selengkapnya, lihat topik berikut:

   • Ringkasan pemberitahuan
   • PromQL di Cloud Monitoring

3. Konfigurasikan saluran notifikasi yang ingin Anda gunakan untuk menerima peringatan. Untuk tujuan redundansi, sebaiknya buat beberapa jenis saluran notifikasi. Untuk informasi selengkapnya, lihat Membuat dan mengelola saluran notifikasi.

4. Jika kueri PromQL dalam kebijakan pemberitahuan Anda menggunakan metrik kustom, metrik tersebut harus sudah ada.

Membuat kebijakan pemberitahuan PromQL

Untuk membuat kebijakan pemberitahuan dengan kondisi berbasis PromQL dari konsol Google Cloud, lakukan hal berikut:

1. Di konsol Google Cloud, buka halaman  Alerting:

   Buka Pemberitahuan

   Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

2. Di halaman Alerting, klik Create Policy.

3. Di bagian Mode konfigurasi kebijakan, pilih Editor kode (MQL atau PromQL).

4. Pastikan PromQL dipilih di tombol Language. Tombol bahasa berada di toolbar yang sama yang memungkinkan Anda memformat kueri.

5. Masukkan kueri PromQL yang memilih data yang ingin Anda pantau. Jika Auto-run tidak diaktifkan, klik Run Query.

   Misalnya, kueri berikut merangkum rasio data logging penagihan yang diserap selama interval 60 detik dan menentukan apakah rasio yang diringkas lebih dari 300 byte:

   sum(rate(logging_googleapis_com:billing_bytes_ingested{monitored_resource="global"}[60s]))>300
   

   Setelah menjalankan kueri, Anda akan melihat diagram. Untuk satu project, kueri ini menghasilkan hasil berikut:

   

6. Klik Next dan konfigurasikan pemicu pemberitahuan.

   1. Pilih nilai untuk Pemicu pemberitahuan. Nilai ini menentukan jumlah deret waktu yang ditampilkan oleh kueri yang harus memenuhi operasi pemberitahuan sebelum kebijakan pemberitahuan dapat dipicu. Anda dapat memilih dari kriteria berikut:

      • Deret waktu apa pun.
      • Persentase deret waktu.
      • Jumlah deret waktu tertentu.
      • Semua deret waktu.

   2. Pilih Jendela pengujian ulang. Kolom ini menentukan durasi kondisi harus terpenuhi sebelum kebijakan pemberitahuan dipicu.

      Nilai defaultnya adalah 0 detik. Dengan setelan ini, satu pengukuran dapat menghasilkan notifikasi. Untuk informasi selengkapnya dan contoh, lihat Setelan durasi dan periode perataan.

   3. Untuk memilih seberapa sering pemberitahuan mengevaluasi kueri PromQL, pilih nilai untuk Interval evaluasi.

      Catatan: Insiden yang dibuat oleh kebijakan pemberitahuan dengan kondisi berbasis PromQL tidak mengikuti durasi penutupan otomatis kebijakan pemberitahuan. Sebagai gantinya, insiden akan otomatis ditutup saat mencapai waktu yang ditetapkan setelah terakhir kali kondisi terpenuhi. Waktu ini lebih besar dari 270 detik dan dua kali interval evaluasi kondisi.

   4. Masukkan nama untuk kondisi, lalu klik Berikutnya.

7. Tambahkan saluran notifikasi.

8. Opsional: Tambahkan label kebijakan pemberitahuan dan dokumentasi.

9. Klik Alert name dan masukkan nama untuk kebijakan pemberitahuan itu.

10. Klik Create policy.

Untuk mengetahui langkah selengkapnya, lihat Mengelola kebijakan pemberitahuan.