Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Bekerja dengan kebijakan notifikasi
Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.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 9.x, lihat. Bekerja di Grafana versi 9
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
-
Dari konsol Grafana Anda, di menu Grafana, pilih ikon Peringatan (bel) untuk membuka halaman Peringatan.
-
Pilih Kebijakan pemberitahuan.
-
Dari dropdown Alertmanager, pilih Alertmanager yang ingin Anda edit.
-
Di bagian Kebijakan Root, pilih ikon Edit (pena).
-
Di titik kontak default, perbarui titik kontak tempat pemberitahuan harus dikirim untuk aturan saat aturan peringatan tidak cocok dengan kebijakan tertentu.
-
Di Grup menurut, pilih label (atau grup khusus) untuk mengelompokkan peringatan berdasarkan.
-
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.
-
-
Pilih Simpan untuk menyimpan perubahan Anda.
Untuk menambahkan kebijakan spesifik tingkat atas yang baru
-
Dari konsol Grafana Anda, di menu Grafana, pilih ikon Peringatan (bel) untuk membuka halaman Peringatan.
-
Pilih Kebijakan pemberitahuan.
-
Dari dropdown Alertmanager, pilih Alertmanager yang ingin Anda edit.
-
Di bagian Perutean khusus, pilih Kebijakan spesifik baru.
-
Di bagian Mencocokkan label, tambahkan satu atau beberapa label peringatan yang cocok. Informasi lebih lanjut tentang pencocokan label nanti dalam topik ini.
-
Di titik Kontak, tambahkan titik kontak untuk mengirim notifikasi jika peringatan cocok dengan kebijakan khusus ini. Kebijakan bersarang mengesampingkan titik kontak ini.
-
Secara opsional pilih Ganti pengelompokan untuk menentukan pengelompokan yang berbeda dari kebijakan root.
-
Secara opsional pilih Ganti pengaturan waktu umum untuk mengganti opsi waktu dalam kebijakan pemberitahuan grup.
-
Pilih Simpan kebijakan untuk menyimpan perubahan Anda.
Untuk menambahkan kebijakan bersarang
-
Perluas kebijakan spesifik yang ingin Anda buat kebijakan bersarang di bawahnya.
-
Pilih Tambahkan kebijakan bertingkat, lalu tambahkan detailnya (seperti saat menambahkan kebijakan spesifik tingkat atas).
-
Pilih Simpan kebijakan untuk menyimpan perubahan Anda.
Untuk mengedit kebijakan tertentu
-
Dari halaman Peringatan, pilih Kebijakan pemberitahuan untuk membuka halaman yang mencantumkan kebijakan yang ada.
-
Pilih kebijakan yang ingin Anda edit, lalu pilih ikon Edit (pena).
-
Buat perubahan apa pun (seperti saat menambahkan kebijakan spesifik tingkat atas).
-
Pilih Simpan kebijakan.
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. Hal ini dapat cocok sebagai string atau sebagai ekspresi reguler, tergantung pada operator yang dipilih.
Bisukan waktu
Waktu bisu adalah interval waktu berulang ketika tidak ada pemberitahuan baru untuk kebijakan yang dibuat atau dikirim. Gunakan mereka untuk mencegah peringatan menembakkan periode tertentu dan berulang, misalnya, periode pemeliharaan rutin.
Mirip dengan keheningan, pengaturan waktu bisu tidak mencegah aturan peringatan dievaluasi, juga tidak menghentikan instance peringatan ditampilkan di antarmuka pengguna. Mereka hanya mencegah pemberitahuan dibuat.
Anda dapat mengonfigurasi pengaturan waktu bisu terkelola Grafana serta pengaturan waktu bisu untuk sumber data Alertmanager eksternal.
Pengaturan waktu bisu dibandingkan dengan keheningan
Tabel berikut menyoroti perbedaan antara timing bisu dan keheningan.
Bisukan waktu | Diam |
---|---|
Menggunakan definisi interval waktu yang dapat terulang kembali |
Memiliki waktu mulai dan berakhir yang tetap |
Dibuat dan kemudian ditambahkan ke kebijakan pemberitahuan |
Menggunakan label untuk mencocokkan dengan peringatan untuk menentukan apakah akan diam atau tidak |
Untuk membuat waktu bisu
-
Dari konsol Grafana Anda, di menu Grafana, pilih ikon Peringatan (bel) untuk membuka halaman Peringatan.
-
Pilih Kebijakan pemberitahuan.
-
Dari dropdown Alertmanager, pilih Alertmanager yang ingin Anda edit.
-
Di bagian Mute timing, pilih tombol Add mute timing.
-
Pilih interval waktu yang Anda inginkan untuk menerapkan waktu bisu.
-
Pilih Kirim untuk membuat waktu bisu.
Untuk menambahkan waktu bisu ke kebijakan notifikasi
-
Pilih kebijakan notifikasi yang ingin Anda tambahkan waktu bisu, lalu pilih tombol Edit.
-
Dari menu tarik-turun Pengaturan waktu bisu, pilih pengaturan waktu bisu yang ingin ditambahkan ke kebijakan.
Pilih tombol Simpan kebijakan.
Interval waktu
Interval waktu adalah definisi untuk rentang waktu. Jika peringatan dimulai selama interval ini, peringatan itu ditekan. Rentang didukung menggunakan :
(misalnya,monday:thursday
). Waktu bisu dapat berisi beberapa interval waktu. Interval waktu terdiri dari beberapa bidang (detail dalam daftar berikut), yang semuanya harus cocok untuk menekan peringatan. Misalnya, jika Anda menentukan hari dalam seminggu monday:friday
dan rentang waktu dari 8:00-9:00, maka peringatan ditekan dari 8-9, Senin hingga Jumat, tetapi tidak, misalnya, 8-9 pada hari Sabtu.
-
Rentang waktu — Waktu hari untuk menekan notifikasi. Terdiri dari dua sub-bidang, Start time dan End time. Contoh waktu adalah
14:30
. Waktu dalam notasi 24 jam, di UTC. -
Hari dalam seminggu — Hari-hari dalam seminggu. Dapat berupa satu hari, seperti
monday
, rentang, sepertimonday:friday
, atau daftar hari yang terpisah koma, seperti.monday, tuesday, wednesday
-
Bulan — Bulan untuk memilih. Anda dapat menentukan bulan dengan penunjukan numerik, atau dengan nama bulan penuh, misalnya
1
ataujanuary
keduanya menentukan Januari. Anda dapat menentukan satu bulan, rentang bulan, atau daftar bulan yang dipisahkan koma. -
Hari dalam sebulan — Tanggal dalam sebulan. Nilai dapat berkisar dari
1
-31
. Nilai negatif menentukan hari dalam sebulan dalam urutan terbalik, jadi-1
mewakili hari terakhir bulan itu. Hari dalam sebulan dapat ditentukan sebagai satu hari, rentang hari, atau daftar hari yang terpisah koma.