Application Real-Time Monitoring Service:Buat templat aturan peringatan Prometheus

Buat templat aturan peringatan Prometheus

1. Masuk ke ARMS console.

2. Di panel navigasi sebelah kiri, pilih Managed Service for Prometheus > Prometheus Alert Rule Template.

3. Di pojok kanan atas halaman, klik Create Prometheus Alert Rule Template.

4. Pada halaman Create Prometheus Alert Rule, konfigurasikan parameter berikut.

   Anda dapat membuat templat aturan peringatan Prometheus menggunakan ambang batas statis atau PromQL kustom.

   • Tipe pemeriksaan ambang batas statis menyediakan metrik peringatan yang telah ditentukan sebelumnya. Anda dapat memilih metrik yang telah ditentukan untuk membuat aturan peringatan secara cepat.

   • Untuk memantau metrik yang tidak tersedia dalam daftar preset, Anda dapat menggunakan tipe pemeriksaan PromQL kustom untuk membuat aturan peringatan.

   Tabel 1. Tipe pemeriksaan ambang batas statis

   Parameter	Deskripsi	Contoh
   Nama templat aturan peringatan	Nama templat aturan peringatan.	Peringatan utilisasi CPU kontainer – kluster produksi
   Deskripsi templat aturan peringatan	Opsional. Jelaskan templat ini. Anda dapat mencantumkan tujuan, skenario penggunaan, atau catatan lainnya.	Tidak ada
   Tipe pemeriksaan	Pilih Static Threshold.	Static Threshold
   Grup peringatan	Pilih grup peringatan.	Kubernetes Workloads
   Metrik peringatan	Pilih metrik yang ingin Anda konfigurasikan untuk peringatan. Setiap grup peringatan memiliki metrik yang berbeda.	Utilisasi CPU kontainer
   Kondisi peringatan	Tetapkan kondisi untuk memicu event peringatan berdasarkan konten preset dari metrik peringatan.	Kondisi peringatan terpenuhi saat utilisasi CPU Kontainer lebih besar dari 80%.
   Kondisi filter	Berdasarkan metrik peringatan, tetapkan cakupan aturan peringatan. Event peringatan dipicu untuk resource apa pun yang memenuhi kedua kondisi: filter dan peringatan. Kondisi filter yang tersedia adalah: Traverse: Aturan peringatan berlaku untuk semua resource dalam instans Prometheus saat ini. Secara default, kondisi filter diatur ke Traversal. Equal To: Setelah memilih kondisi ini, masukkan nama resource spesifik. Aturan peringatan hanya akan berlaku untuk resource tersebut. Anda tidak dapat memasukkan beberapa resource. Is not equal: Setelah memilih kondisi ini, masukkan nama resource spesifik. Aturan peringatan akan berlaku untuk semua resource kecuali yang dimaksud. Anda tidak dapat memasukkan beberapa resource. Match Regular Expression: Setelah memilih kondisi ini, masukkan ekspresi reguler untuk mencocokkan nama resource. Aturan peringatan akan berlaku untuk semua resource yang cocok dengan ekspresi tersebut. Do Not Match Regular Expression: Setelah memilih kondisi ini, masukkan ekspresi reguler untuk mencocokkan nama resource. Aturan peringatan akan mengecualikan semua resource yang cocok dengan ekspresi tersebut.	IP Instance: Traverse
   Durasi	Memicu event peringatan segera setelah kondisi peringatan terpenuhi: Event peringatan dipicu jika ada titik data yang melebihi ambang batas. Memicu event peringatan hanya jika kondisi peringatan bertahan selama N menit: Event peringatan dipicu hanya jika ambang batas terlampaui selama N menit atau lebih.	1
   Tingkat keparahan peringatan	Tingkat keparahan peringatan. Tingkat keparahan default adalah Default. Tingkat keparahan, dari terendah ke tertinggi, adalah Default, P4, P3, P2, dan P1.	Default
   Konten peringatan	Informasi peringatan yang diterima pengguna. Anda dapat menggunakan sintaks templat Go untuk menyesuaikan variabel parameter peringatan dalam konten peringatan.	Namespace: {{$labels.namespace}} / Pod: {{$labels.pod_name}} / Kontainer: {{$labels.container}} Utilisasi CPU {{$labels.metrics_params_opt_label_value}} {{$labels.metrics_params_value}}%, nilai saat ini {{ printf "%.2f" $value }}%
   Pengaturan Lanjutan
   Label	Tetapkan label peringatan. Label ini dapat digunakan sebagai opsi untuk aturan pencocokan dalam kebijakan notifikasi.	Tidak ada
   Anotasi	Tetapkan anotasi untuk peringatan.	Tidak ada

   Tabel 2. Tipe pemeriksaan PromQL kustom

   Parameter	Deskripsi	Contoh
   Nama templat aturan peringatan	Nama templat aturan peringatan.	Utilisasi CPU Pod lebih besar dari 80%
   Deskripsi templat aturan peringatan	Opsional. Jelaskan templat ini. Anda dapat mencantumkan tujuan, skenario penggunaan, atau catatan lainnya.	Tidak ada
   Tipe pemeriksaan	Atur ke Custom PromQL.	Custom PromQL
   Pernyataan PromQL kustom	Gunakan pernyataan PromQL untuk menetapkan ekspresi aturan peringatan.	max(container_fs_usage_bytes{pod!="", namespace!="arms-prom",namespace!="monitoring"}) by (pod_name, namespace, device)/max(container_fs_limit_bytes{pod!=""}) by (pod_name,namespace, device) * 100 > 90
   Durasi	Memicu event peringatan segera setelah kondisi peringatan terpenuhi: Event peringatan dipicu jika ada titik data yang melebihi ambang batas. Memicu event peringatan hanya jika kondisi peringatan bertahan selama N menit: Event peringatan dipicu hanya jika ambang batas terlampaui selama N menit atau lebih.	1
   Tingkat keparahan peringatan	Tingkat keparahan peringatan. Tingkat keparahan default adalah Default. Tingkat keparahan, dari terendah ke tertinggi, adalah Default, P4, P3, P2, dan P1.	Default
   Konten peringatan	Informasi peringatan yang diterima pengguna. Anda dapat menggunakan sintaks templat Go untuk menyesuaikan variabel parameter peringatan dalam konten peringatan.	Namespace: {{$labels.namespace}}/Pod: {{$labels.pod_name}}/Perangkat disk: {{$labels.device}} utilisasi melebihi 90%, nilai saat ini {{ printf "%.2f" $value }}%
   Pengaturan Lanjutan
   Label	Tetapkan label peringatan. Label ini dapat digunakan sebagai opsi untuk aturan pencocokan dalam kebijakan notifikasi.	Tidak ada
   Anotasi	Tetapkan anotasi untuk peringatan.	Tidak ada

Templat aplikasi

Setelah membuat templat peringatan Prometheus, Anda dapat menerapkannya untuk membuat aturan peringatan pada instans Prometheus. Anda juga dapat menggunakan templat tersebut untuk memperbarui aturan peringatan yang sudah ada pada instans Prometheus.

1. Pada halaman Prometheus Alert Rule Template, klik Apply Template untuk templat yang ingin Anda terapkan.

2. Pada halaman Apply Template, di tab Prometheus Instance Selection Mode, pilih instans Prometheus lalu klik OK.

   Catatan

   Anda dapat memfilter instans Prometheus yang terkait dengan templat peringatan ini berdasarkan nama instans Prometheus, wilayah, dan tipe instans Prometheus.

3. Di kotak dialog yang muncul, pilih apakah akan memperbarui aturan peringatan yang sudah ada, lalu klik OK.

   ARMS menggunakan templat aturan peringatan saat ini untuk membuat aturan peringatan di instans Prometheus yang dipilih.

   • Jika Anda tidak memilih Update Existing Alert Rules: Jika instans Prometheus yang dipilih sudah memiliki aturan peringatan yang dibuat dari templat peringatan saat ini, pesan Alert Rules Have Already Been Created By Using This Template And Will Not Be Updated akan muncul. Aturan peringatan yang sudah ada tidak diperbarui.

   • Update Existing Alert Rules: Jika instans Prometheus yang dipilih sudah berisi aturan peringatan yang dibuat dari templat peringatan saat ini, aturan peringatan Prometheus tersebut diperbarui agar sesuai dengan konten terbaru dari templat peringatan.

     Penting

     Jika suatu aturan peringatan telah dimodifikasi secara individual tetapi pemetaannya ke templat tetap dipertahankan, modifikasi individual tersebut akan ditimpa dan hilang.

Hapus templat

Jika templat peringatan Prometheus tidak lagi diperlukan, Anda dapat menghapus templat peringatan Prometheus tersebut. Saat menghapus templat, Anda dapat menentukan apakah akan menyimpan aturan peringatan yang dibuat darinya.

1. Pada halaman Prometheus Alert Rule Template, klik Delete di sebelah kanan templat aturan peringatan yang dituju.

2. Di kotak dialog yang muncul, pilih apakah akan menghapus juga aturan peringatan yang dibuat dari templat tersebut, lalu klik Confirm.

   • Pilih Delete Alert Rules Created from Template: Aturan peringatan Prometheus yang terkait dengan templat akan dihapus. Jika aturan peringatan Prometheus yang dibuat dari templat telah diedit secara manual dan Anda memilih Do Not Retain The Mapping Between The Template And The Rule saat menyimpannya, aturan tersebut tidak dihapus.

   • Jika Anda tidak memilih Delete Alert Rules Created from Template, aturan peringatan Prometheus yang dibuat dari templat akan dipertahankan.

Lihat aturan peringatan yang dibuat dari templat

Anda dapat melihat dan mengelola aturan peringatan yang dibuat dari templat secara batch.

1. Pada halaman Prometheus Alert Rule Template, klik View Rules Created From Template di sebelah kanan templat aturan peringatan yang dituju.

2. Anda dapat mengelola aturan peringatan secara batch pada halaman Alert Rules Created from Template.

   • Untuk mengaktifkan peringatan secara batch: Pilih aturan peringatan yang diinginkan lalu klik Enable Alert Rules.

   • Untuk menonaktifkan peringatan secara batch: Pilih aturan peringatan yang diinginkan lalu klik Disable Alert Rules.

   • Untuk menghapus peringatan secara batch: Pilih aturan peringatan yang diinginkan lalu klik Delete Alert Rules.

Catatan

Saat mengedit dan menyimpan aturan peringatan Prometheus yang dibuat dari templat aturan peringatan Prometheus, Anda harus memilih apakah akan mempertahankan pemetaan antara templat dan aturan tersebut.

• Retain the mapping between this alert rule and the alert rule template: Jika Anda mempertahankan pemetaan ini, editan Anda saat ini mungkin ditimpa jika Anda menerapkan templat aturan peringatan yang sesuai ke instans Prometheus untuk aturan ini dan memilih opsi pembaruan paksa.

• Remove the mapping between this alert rule and the alert rule template: Setelah pemetaan dinonaktifkan, aturan peringatan ini dianggap sebagai aturan independen. Kami menyarankan agar Anda mengubah nama aturan peringatan tersebut. Jika tidak, saat Anda menerapkan kembali templat aturan peringatan yang sesuai ke instans Prometheus, pembuatan akan gagal karena terjadi duplikasi nama aturan peringatan.