Bekerja dengan kebijakan pemberitahuan

Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.

Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. Bekerja di Grafana versi 10

Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. Bekerja di Grafana versi 8

Kebijakan pemberitahuan menentukan bagaimana peringatan diarahkan ke titik kontak. Kebijakan memiliki struktur pohon, di mana setiap kebijakan dapat memiliki satu atau lebih kebijakan anak. Setiap kebijakan, kecuali kebijakan root, juga dapat mencocokkan label peringatan tertentu. Setiap peringatan dievaluasi oleh kebijakan root dan kemudian oleh setiap kebijakan anak. Jika Anda mengaktifkan Continue matching subsequent sibling nodes opsi untuk kebijakan tertentu, evaluasi berlanjut bahkan setelah satu atau lebih kecocokan. Pengaturan konfigurasi kebijakan induk dan informasi titik kontak mengatur perilaku peringatan yang tidak cocok dengan kebijakan turunan mana pun. Kebijakan root mengatur peringatan apa pun yang tidak cocok dengan kebijakan tertentu.

catatan

Anda dapat membuat dan mengedit kebijakan notifikasi untuk lansiran terkelola Grafana. Kebijakan pemberitahuan untuk peringatan Alertmanager hanya bisa dibaca.

Pemberitahuan pengelompokan

Pengelompokan mengkategorikan notifikasi peringatan yang sifatnya serupa ke dalam satu corong. Ini memungkinkan Anda untuk mengontrol pemberitahuan peringatan selama pemadaman yang lebih besar ketika banyak bagian dari sistem gagal sekaligus menyebabkan sejumlah besar peringatan dimulai secara bersamaan.

Contoh pengelompokan

Misalkan Anda memiliki 100 layanan yang terhubung ke database di lingkungan yang berbeda. Layanan ini dibedakan oleh labelenv=environmentname. Aturan peringatan ada untuk memantau apakah layanan Anda dapat mencapai database. Aturan peringatan membuat peringatan bernamaalertname=DatabaseUnreachable.

Jika partisi jaringan terjadi, di mana setengah dari layanan Anda tidak dapat lagi mencapai database, 50 peringatan berbeda dimulai. Untuk situasi ini, Anda ingin menerima pemberitahuan satu halaman (sebagai lawan dari 50) dengan daftar lingkungan yang terpengaruh.

Anda dapat mengonfigurasi pengelompokan menjadi group_by: [alertname] (tidak menggunakan env label, yang berbeda untuk setiap layanan). Dengan konfigurasi ini, Grafana mengirimkan satu notifikasi ringkas yang memiliki semua lingkungan yang terpengaruh untuk aturan peringatan ini.

Grup Khusus

Grafana memiliki dua kelompok khusus. Grup default, group_by: null mengelompokkan semua peringatan menjadi satu grup. Anda juga dapat menggunakan label khusus yang diberi nama ... untuk mengelompokkan peringatan berdasarkan semua label, menonaktifkan pengelompokan secara efektif, dan mengirim setiap peringatan ke dalam grupnya sendiri.

Bekerja dengan notifikasi

Prosedur berikut menunjukkan cara membuat dan mengelola kebijakan notifikasi.

Untuk mengedit kebijakan pemberitahuan root

1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon Peringatan (bel) untuk membuka halaman Peringatan.

2. Pilih Kebijakan pemberitahuan.

3. Dari dropdown Alertmanager, pilih Alertmanager yang ingin Anda edit.

4. Di bagian Kebijakan Root, pilih ikon Edit (pena).

5. Di titik kontak default, perbarui titik kontak tempat pemberitahuan harus dikirim untuk aturan saat aturan peringatan tidak cocok dengan kebijakan tertentu.

6. Di Grup menurut, pilih label (atau grup khusus) untuk mengelompokkan peringatan berdasarkan.

7. Di Opsi waktu, pilih dari opsi berikut.

   • Tunggu grup — Saatnya menunggu untuk menyangga peringatan dari grup yang sama sebelum mengirim pemberitahuan awal. Waktu default-nya adalah 30 detik.

   • Interval grup — Interval waktu minimum antara dua pemberitahuan untuk grup. Default adalah 5 menit.

   • Interval pengulangan — Interval waktu minimum sebelum mengirim ulang pemberitahuan jika tidak ada peringatan baru yang ditambahkan ke grup. Defaultnya adalah 4 jam.

8. Pilih Simpan untuk menyimpan perubahan Anda.

Untuk menambahkan kebijakan spesifik tingkat atas yang baru

1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon Peringatan (bel) untuk membuka halaman Peringatan.

2. Pilih Kebijakan pemberitahuan.

3. Dari dropdown Alertmanager, pilih Alertmanager yang ingin Anda edit.

4. Di bagian Perutean khusus, pilih Kebijakan spesifik baru.

5. Di bagian Mencocokkan label, tambahkan satu atau beberapa label peringatan yang cocok. Informasi lebih lanjut tentang pencocokan label nanti dalam topik ini.

6. Di titik Kontak, tambahkan titik kontak untuk mengirim notifikasi jika peringatan cocok dengan kebijakan khusus ini. Kebijakan bersarang mengesampingkan titik kontak ini.

7. Secara opsional, aktifkan Lanjutkan pencocokan node saudara berikutnya untuk terus mencocokkan kebijakan saudara kandung bahkan setelah peringatan cocok dengan kebijakan saat ini. Jika kebijakan ini diaktifkan, Anda bisa mendapatkan lebih dari satu notifikasi untuk peringatan yang sama.

8. Secara opsional pilih Ganti pengelompokan untuk menentukan pengelompokan yang berbeda dari kebijakan root.

9. Secara opsional pilih Ganti pengaturan waktu umum untuk mengganti opsi waktu dalam kebijakan pemberitahuan grup.

10. Pilih Simpan kebijakan untuk menyimpan perubahan Anda.

Untuk menambahkan kebijakan bersarang

1. Perluas kebijakan spesifik yang ingin Anda buat kebijakan bersarang.

2. Pilih Tambahkan kebijakan bertingkat, lalu tambahkan detailnya (seperti saat menambahkan kebijakan spesifik tingkat atas).

3. Pilih Simpan kebijakan untuk menyimpan perubahan Anda.

Untuk mengedit kebijakan tertentu

1. Dari halaman Peringatan, pilih Kebijakan pemberitahuan untuk membuka halaman yang mencantumkan kebijakan yang ada.

2. Pilih kebijakan yang ingin Anda edit, lalu pilih ikon Edit (pena).

3. Buat perubahan apa pun (seperti saat menambahkan kebijakan spesifik tingkat atas).

4. Pilih Simpan kebijakan.

Mencari kebijakan

Anda dapat mencari di dalam pohon kebijakan berdasarkan pencocokan Label atau titik kontak.

• Untuk mencari berdasarkan titik kontak, masukkan nama sebagian atau lengkap titik kontak di bidang Cari berdasarkan titik kontak.

• Untuk mencari berdasarkan label, masukkan pencocokan label yang valid di kolom Cari berdasarkan label. Beberapa matcher dapat dimasukkan, dipisahkan dengan koma. Misalnya, masukan pencocokan yang valid bisa severity=high, region=~EMEA|NA jadi.

  catatan

  Saat mencari berdasarkan label, semua kebijakan yang cocok akan sama persis. Pertandingan sebagian dan pertandingan gaya regeks tidak didukung.

Cara kerja pencocokan label

Kebijakan akan cocok dengan peringatan jika label peringatan cocok dengan semua Label Pencocokan yang ditentukan pada kebijakan.

• Label — Nama label yang cocok. Itu harus sama persis dengan nama label peringatan.

• Operator — Operator digunakan untuk membandingkan nilai label dengan nilai label yang cocok. Operator yang tersedia adalah:

  • =Pilih label yang nilainya sama persis dengan string yang disediakan.

  • !=Pilih label yang nilainya tidak cocok dengan string yang disediakan.

  • =~Pilih label yang nilainya cocok dengan nilai interpretasi regex dari string yang disediakan (string yang disediakan ditafsirkan sebagai ekspresi reguler.

  • !=Pilih label yang tidak cocok dengan ekspresi reguler yang disediakan.

• Nilai — Nilai untuk mencocokkan nilai label. Ini dapat cocok sebagai string atau sebagai ekspresi reguler, tergantung pada operator yang dipilih.