Integrasikan peringatan Grafana - Application Real-Time Monitoring Service

Grafana adalah platform open-source untuk monitoring dan observabilitas yang memungkinkan Anda melakukan kueri, visualisasi, serta mengirim peringatan berdasarkan metrik dari berbagai sumber data. Dengan mengintegrasikan Grafana ke ARMS Alert Management, Anda dapat meneruskan peringatan Grafana ke ARMS guna penanganan peringatan terpusat, routing notifikasi, dan respons insiden.

Integrasi ini mencakup dua langkah: buat titik akhir integrasi di ARMS, lalu konfigurasikan Grafana agar mengirim peringatan ke titik akhir tersebut.

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

Akun Alibaba Cloud dengan Application Real-Time Monitoring Service (ARMS) yang telah diaktifkan
Instans Grafana yang sedang berjalan (self-hosted atau Grafana Cloud)

Buat integrasi Grafana di ARMS

Masuk ke Konsol ARMS.
Pada panel navigasi sebelah kiri, pilih Alert Management > Integrations.
Pada tab Alert Integration, klik Grafana.
Pada kotak dialog Create Grafana Integration, masukkan nama integrasi dan atur waktu pemulihan otomatis untuk event peringatan, lalu klik Save.
Catatan
Jika suatu event peringatan tidak dipicu lagi dalam rentang waktu pemulihan otomatis, ARMS akan secara otomatis menutupnya.
Pada tab Alert Integration, temukan integrasi Grafana yang telah Anda buat dan salin integration endpoint. Anda memerlukan URL ini saat mengonfigurasi Grafana.

Konfigurasikan Grafana untuk mengirim peringatan ke ARMS

Di Grafana, navigasikan ke Alerting > Notification channels pada panel navigasi sebelah kiri.
Klik New channel. Jika ini adalah channel notifikasi pertama Anda, klik Add channel sebagai gantinya.
Pada halaman New notification channel, konfigurasikan pengaturan berikut:
1. Name: Masukkan nama untuk channel notifikasi ini.
2. Type: Pilih webhook.
3. URL: Tempel integration endpoint yang disalin dari ARMS.
4. Di bawah Notification settings, centang kotak pilihan berikut:
  - Default
  - Include image
  - Send reminders — Mengirim notifikasi berulang untuk peringatan aktif. Atur frekuensi pengingat ke nilai yang tidak melebihi waktu pemulihan otomatis yang dikonfigurasi di ARMS.
    Catatan
    Jika Anda tidak memilih Send reminders, setiap peringatan hanya dilaporkan ke ARMS satu kali.
Klik Test untuk memverifikasi bahwa Grafana dapat terhubung ke ARMS Alert Management.
Setelah pengujian berhasil, klik OK.

Verifikasi integrasi

Setelah konfigurasi selesai, peringatan Grafana akan diteruskan ke ARMS Alert Management secara otomatis.

Untuk memastikan peringatan telah diterima:

Di Konsol ARMS, buka Alert Management > Alert Event History.
Klik nama event peringatan untuk melihat detailnya.

Untuk informasi lebih lanjut, lihat View historical alert events.

(Opsional) Sesuaikan pemetaan field dan deduplikasi

ARMS menyediakan pemetaan field default antara muatan peringatan Grafana dan event peringatan ARMS. Untuk menambah atau mengubah pemetaan ini, edit integrasinya.

Kirim data uji

Pada tab Alert Integration, temukan integrasi Grafana dan klik Edit pada kolom Actions.
Pada bagian Event Mapping, klik Send Test Data.

Pada kotak dialog Send Test Data, masukkan contoh muatan peringatan Grafana dalam format JSON, lalu klik Send.

Contoh muatan peringatan Grafana:

{
       "@timestamp": "2021-09-09T12:25:09.556Z",
       "orgId": 0,
       "host": "10.1.11.14",
       "ruleName": "Test notification",
       "ruleUrl": "http://localhost:8001/grafana/",
       "state": "alerting",
       "title": "[Alerting] Test notification",
       "panelId": 1,
       "imageUrl": "https://grafana.com/assets/img/blog/mixed_styles.png",
       "evalMatches": [
           {
               "metric": "High value",
               "value": 100,
               "tags": null
           },
           {
               "metric": "Higher Value",
               "value": 200,
               "tags": null
           }
       ],
       "ruleId": 0,
       "tags": {},
       "dashboardId": 1,
       "message": "Someone is testing the alert notification within grafana.",
       "@version": "1"
   }

Setelah dikirim, salah satu pesan berikut akan muncul:

Pesan	Makna
Uploaded. No events are generated. Configure mappings based on the original data.	Field sumber peringatan belum dipetakan ke field event peringatan ARMS. Data mentah muncul di panel kiri sehingga Anda dapat memilih field sumber saat mengonfigurasi pemetaan.
Uploaded.	Peringatan berhasil dilaporkan ke halaman Alert Event History. Untuk informasi lebih lanjut, lihat View historical alert events.

Send Test Data

Pada kotak dialog Send Test Data, klik Disable.

Konfigurasikan pemetaan field

Pada panel kiri bagian Event Mapping, klik catatan data untuk melihat detailnya. Di panel kanan, petakan field sumber peringatan Grafana ke field peringatan ARMS.

Pilih node root (pemrosesan batch)

Jika muatan peringatan berisi node array, tetapkan node tersebut sebagai node root untuk memproses elemennya secara iteratif.

Pilih Use Batch Processing, lalu pilih node array yang akan digunakan sebagai node root.

Catatan

Hanya satu node array yang dapat dipilih untuk pemrosesan batch dalam satu waktu.

Sebagai contoh, node array evalMatches pada muatan contoh di atas berisi dua elemen, masing-masing dengan field value:

Dengan pemrosesan batch: $.evalMatches[*].value memetakan semua field value dalam array ke field peringatan ARMS yang ditentukan secara iteratif.
Tanpa pemrosesan batch: Petakan elemen individual seperti $.evalMatches[0].value atau $.evalMatches[1].value ke field peringatan ARMS secara terpisah.

Petakan field sumber ke field target

Klik ikon Map untuk memilih salah satu metode pemetaan berikut:

Metode	Deskripsi
Direct	Memetakan satu field Grafana ke satu field peringatan ARMS.
Series	Menggabungkan beberapa field Grafana dengan pembatas (hanya karakter khusus), lalu memetakan hasilnya ke field peringatan ARMS. Misalnya, `$.host` dan `$.title` digabung dengan `_` menghasilkan `$.host_$.title`, yang dipetakan ke field `alertname`.
Condition	Memetakan field Grafana ke field peringatan ARMS hanya jika nilai field memenuhi kondisi tertentu.
Mapping table	Memetakan tingkat severity dari sumber peringatan Grafana ke tingkat severity ARMS. Gunakan metode ini hanya untuk field `severity`.

Referensi field peringatan ARMS

Field peringatan	Deskripsi
`alertname`	Nama peringatan kustom.
`severity`	Tingkat peringatan. Konfigurasikan pemetaan untuk field ini menggunakan metode Direct.
`message`	Deskripsi peringatan yang digunakan sebagai konten notifikasi peringatan. Maksimum: 15.000 karakter.
`value`	Nilai metrik contoh.
`imageUrl`	URL grafik metrik Grafana.
`check`	Item pemeriksaan peringatan, seperti CPU, JVM, Application Crash, atau Deployment.
`source`	Sumber peringatan.
`class`	Jenis objek yang memicu event peringatan, seperti host.
`service`	Layanan sumber peringatan, seperti Login Service.
`startat`	Timestamp untuk waktu mulai event.
`endat`	Timestamp untuk waktu akhir event.
`generatorUrl`	URL halaman detail event.

Konfigurasikan deduplikasi event

Deduplikasi event menggabungkan event peringatan duplikat berdasarkan field yang dipilih, sehingga mengurangi kebisingan dalam notifikasi peringatan Anda.

Catatan

Deduplikasi hanya berlaku untuk event yang belum ditutup.

Pada bagian Event Deduplication di halaman Integration Details, pilih field yang akan digunakan sebagai kunci deduplikasi.
Event dengan nilai identik untuk semua field yang dipilih akan digabung menjadi satu notifikasi peringatan. Sebagai contoh, memilih metric dan ruleName sebagai kunci deduplikasi akan menggabungkan event yang memiliki metric dan rule name yang sama, sedangkan event dengan nilai berbeda tetap terpisah.
Klik Deduplication Test untuk melihat pratinjau cara event historis dikelompokkan setelah deduplikasi.
Catatan
Pengujian deduplikasi dijalankan terhadap 10 catatan data terbaru yang diunggah di bagian Event Mapping.
Klik Save.

Kelola integrasi yang ada

Pada tab Alert Integration (Alert Management > Integrations), Anda dapat melakukan operasi berikut:

Operasi	Langkah
Lihat detail integrasi	Klik baris integrasi untuk membuka halaman Integration Details.
Perbarui kunci integrasi	Pilih More > Update Key pada kolom Actions, lalu klik OK.
Edit integrasi	Klik Edit pada kolom Actions, ubah pengaturan, lalu klik Save.
Aktifkan atau nonaktifkan integrasi	Klik Enable atau Disable pada kolom Actions.
Hapus integrasi	Klik Delete pada kolom Actions, lalu klik OK.
Tambahkan alur pemrosesan event	Klik Add Event Processing Flow pada kolom Actions. Untuk informasi lebih lanjut, lihat Work with event processing flows.
Buat kebijakan notifikasi	Pilih More > Create Notification Policy pada kolom Actions. Untuk informasi lebih lanjut, lihat Create and manage a notification policy.

Penting

Setelah memperbarui kunci integrasi, perbarui URL webhook di channel notifikasi Grafana Anda agar sesuai dengan integration endpoint baru.

Langkah selanjutnya

Buat kebijakan notifikasi untuk mengontrol cara ARMS menghasilkan dan merutekan notifikasi peringatan untuk peringatan Grafana Anda. Untuk informasi lebih lanjut, lihat Create and manage a notification policy.

Untuk meninjau peringatan yang dihasilkan oleh kebijakan notifikasi Anda, lihat View historical alerts.