Managed Service for Prometheus:Kebijakan notifikasi

Buat kebijakan notifikasi

1. Masuk ke Managed Service for Prometheus console. Di panel navigasi kiri, pilih Alert Management > Notification Policies.

2. Pada halaman Notification Policies, klik Create Notification Policy.

3. Di bagian atas halaman Create Notification Policy, masukkan nama untuk kebijakan tersebut.

4. Pada bagian Matching Rule, tentukan aturan pencocokan untuk event peringatan.

   Penting

   Kebijakan diam memiliki prioritas lebih tinggi daripada kebijakan notifikasi. Event peringatan yang sesuai dengan kebijakan diam akan dibungkam dan tidak dievaluasi terhadap kebijakan notifikasi apa pun. Untuk membuat kebijakan diam, lihat Kebijakan diam.

   1. Pilih sumber data.

      • Specific source: Menyaring event peringatan dari integrasi tertentu.

      • No preset source: Menyaring event peringatan dari semua integrasi.

   2. Tentukan ekspresi aturan pencocokan. Anda dapat menggunakan tag kustom atau memilih dari tag yang sudah ada.

      Tag yang sudah ada meliputi:

      • Tag dari metrik dalam ekspresi aturan peringatan. Untuk mempelajari cara membuat tag untuk aturan peringatan Managed Service for Prometheus, lihat Buat aturan peringatan Prometheus.

      • Sistem ARMS menyediakan tag default berikut.

        Kategori	Tag	Deskripsi
        Bidang umum	alertname	Nama peringatan.
        	clustername	Nama kluster.
        	severity	Tingkat keparahan: P1 P2 P3 P4 Default
        	namespace	namespace.
        	pod_name	Nama Pod.
        Bidang yang telah ditentukan sistem	_aliyun_arms_integration_name	Nama integrasi. Nama integrasi default untuk peringatan yang dilaporkan oleh ARMS adalah ARMS-DEFAULT.
        	_aliyun_arms_involvedObject_id	ID objek peringatan.
        	_aliyun_arms_involvedObject_name	Nama objek peringatan.
        	_aliyun_arms_region_id	ID wilayah.
        	_aliyun_arms_alert_rule_id	ID aturan peringatan.
        	_aliyun_arms_alert_type	Jenis aturan peringatan: 101: Peringatan Prometheus 5: Peringatan Pemantauan Aplikasi 4: Peringatan Pemantauan Browser
        	_arms_contact_group_v2_id	ID grup kontak (v2) untuk pemberitahuan peringatan. Tag ini secara otomatis ditambahkan oleh ARMS ke tag event peringatan. Nilainya sesuai dengan pengenal grup kontak v2 yang ditampilkan pada halaman Alarm Management > Notification Objects > Contact Group di konsol. Saat kebijakan notifikasi dibuat secara otomatis melalui integrasi ACK, tag ini digunakan untuk mencocokkan kebijakan tanpa konfigurasi manual. Tag ini berbeda dari ContactGroupId v1 yang dikembalikan oleh API. Tag ini terlihat di bidang commonLabels muatan notifikasi webhook.

      Perilaku penampilan tag

      Tag yang ditampilkan pada halaman analisis event peringatan berasal dari label metrik yang dibawa oleh aturan peringatan yang dipicu dan dari bidang yang telah ditentukan sistem. Event peringatan yang berbeda mungkin membawa bidang tag yang berbeda karena aturan peringatan yang terlibat dikaitkan dengan metrik dan jenis resource yang berbeda. Event yang tidak membawa bidang tertentu tidak akan menampilkan tag tersebut. Akibatnya, beberapa tag mungkin muncul pada satu event tetapi tidak pada event lain — perilaku ini diharapkan, bukan kesalahan sistem.

      Misalnya, suatu event hanya membawa tag pod_name jika peringatan tersebut melibatkan resource Pod. Peringatan yang tidak melibatkan Pod tidak akan menampilkan tag ini.

      Catatan

      • Untuk mewajibkan peringatan agar memenuhi semua kondisi dalam suatu aturan (logika AND), klik Add Condition.

      • Untuk mewajibkan peringatan agar memenuhi salah satu aturan (logika OR), klik Add Rule untuk membuat aturan baru.

      • Ukuran total konfigurasi semua aturan pencocokan dalam satu kebijakan notifikasi tidak boleh melebihi 64 KB. Batas ini dapat menampung sekitar 100 aturan, tergantung kompleksitasnya. Melebihi batas ini menyebabkan konfigurasi gagal. Untuk menghindarinya, buat kebijakan notifikasi baru untuk aturan tambahan.

      Catatan

      Ketika kebijakan notifikasi berisi aturan pencocokan berdasarkan dimensi kluster atau objek — misalnya, menggunakan label _aliyun_arms_involvedObject_id untuk mencocokkan ID kluster Kubernetes — aturan peringatan yang terkait dengan kluster atau objek yang cocok akan secara otomatis ditautkan ke kebijakan notifikasi tersebut. Anda tidak perlu mengonfigurasi kebijakan notifikasi pada setiap aturan peringatan secara individual.

      Hal ini sangat berguna dalam skenario massal, seperti aturan peringatan yang dibuat secara otomatis oleh Container Service for Kubernetes (ACK). Anda hanya perlu mengonfigurasi aturan pencocokan berbasis label dalam kebijakan notifikasi untuk secara otomatis mengaitkan semua aturan peringatan terkait sekaligus, tanpa mengedit satu per satu.

      Aturan peringatan yang dibuat secara otomatis oleh kluster ACK membawa tag yang dihasilkan sistem _arms_contact_group_v2_id, yang nilainya merupakan ID grup kontak. Kebijakan notifikasi menggunakan tag ini untuk mencocokkan aturan dan mengarahkan pemberitahuan peringatan ke grup kontak yang ditentukan. Nilai tag ini sesuai dengan ID grup kontak yang ditampilkan pada halaman Alarm Management > Notification Objects > Contact Group di konsol ARMS. Tag ini dihasilkan secara otomatis oleh sistem dan tidak perlu ditambahkan secara manual.

   3. Klik Next.

5. Pada bagian Event Group, konfigurasikan cara pengelompokan event peringatan, lalu klik Next.

   • Do not group: Setiap event peringatan dikirim sebagai notifikasi terpisah.

   • Set grouping fields: Mengelompokkan event peringatan yang memiliki nilai identik untuk bidang yang ditentukan ke dalam satu notifikasi.

6. Pada bagian Notification Objects, konfigurasikan parameter berikut.

   1. Klik +Add Notification Recipient untuk memilih penerima notifikasi.

      Jenis penerima notifikasi:

      • Contact: Anda juga harus memilih metode notifikasi (telepon, pesan teks, atau email) untuk kontak yang dipilih.

      • Contact Group: Anda juga harus memilih metode notifikasi (telepon, pesan teks, atau email) untuk grup kontak yang dipilih.

      • On-call Schedule: Anda juga harus memilih metode notifikasi (telepon, pesan teks, atau email) untuk jadwal piket yang dipilih.

      • DingTalk/Lark/WeCom: Mengirim notifikasi ke channel DingTalk, Lark, atau WeCom.

      • General Webhook: Mengirim notifikasi ke URL webhook yang ditentukan.

   2. Pilih apakah akan mengirim notifikasi pemulihan setelah peringatan terselesaikan.

      Send recovery notification: Jika diaktifkan, notifikasi pemulihan dikirim setelah semua event dalam suatu peringatan terselesaikan, dan status peringatan tersebut kemudian secara otomatis ditandai sebagai Resolved.

   3. Tentukan templat notifikasi. Untuk informasi selengkapnya, lihat Konfigurasikan templat notifikasi dan webhook.

   4. Tentukan periode notifikasi untuk hanya mengirim peringatan dalam rentang waktu tertentu.

   5. Opsi: Pilih sistem tiket untuk mendorong peringatan. Untuk detail tentang cara mengintegrasikan sistem tiket, lihat Integrasi.

   6. Klik Next.

7. Pada bagian Repeat/escalation/recovery policy, konfigurasikan kebijakan untuk peringatan yang belum terselesaikan. Anda dapat mengatur notifikasi ulang, menerapkan kebijakan eskalasi, atau mewajibkan pemulihan manual. Lalu, klik Next.

   • Jika Anda tidak mengonfigurasi kebijakan eskalasi, sistem hanya mengirim satu notifikasi untuk peringatan yang belum terselesaikan.

   • Repeat notifications: Tetapkan frekuensi. Jika peringatan tidak terselesaikan, notifikasi dikirim ulang pada interval yang ditentukan hingga peringatan terselesaikan.

   • Escalation policy: Pilih kebijakan. Jika peringatan tidak terselesaikan, sistem mengirim notifikasi ke penerima tambahan sesuai kebijakan eskalasi yang dipilih.

   • Manual recovery: Jika Anda mengaktifkan opsi ini, peringatan tidak akan terselesaikan secara otomatis meskipun tidak ada event peringatan baru yang dipicu dalam periode resolusi otomatis yang ditentukan dalam integrasi peringatan. Anda harus mengubah status peringatan secara manual.

8. Pada bagian Action Integration, konfigurasikan integrasi aksi untuk dijalankan secara otomatis.

   Jika Anda mengaktifkan opsi ini, Anda harus memilih integrasi aksi yang akan dijalankan saat peringatan dipicu dan saat peringatan terselesaikan. Sistem kemudian akan menjalankannya secara otomatis.

9. Klik Save untuk membuat kebijakan.

Kelola kebijakan notifikasi

Setelah kebijakan notifikasi dibuat, kebijakan tersebut akan ditampilkan pada halaman Notification Policies. Di halaman Notification Policies, Anda dapat melakukan operasi berikut:

• Edit kebijakan notifikasi: Klik nama kebijakan atau klik Edit di kolom Actions. Setelah melakukan perubahan, klik Save.

• Aktifkan atau nonaktifkan kebijakan notifikasi: Di kolom Status, alihkan sakelar.

• Hapus kebijakan notifikasi: Klik Delete di kolom Actions, lalu klik Confirm.

• Salin kebijakan notifikasi: Klik Copy di kolom Actions untuk menduplikasi kebijakan.