Application Real-Time Monitoring Service:Integrasikan peringatan Grafana

Langkah 1: Buat integrasi Grafana

1. Masuk ke Konsol ARMS. Di panel navigasi sebelah kiri, pilih Alert Management > Integrations.

2. Pada tab Alert Integration, klik Grafana.

3. Di kotak dialog New Grafana Integration, masukkan nama dan deskripsi integrasi, pilih versi Grafana, atur timeout pemulihan otomatis untuk event peringatan, lalu klik Save.

   Catatan

   Waktu pemulihan otomatis setelah timeout: Jika event peringatan tidak dipicu lagi dalam periode waktu tertentu, event tersebut akan dihapus secara otomatis.

4. Pada tab Alert Integration, temukan integrasi Grafana baru dan salin endpoint-nya.

   Klik tombol Copy di samping endpoint integrasi.

Langkah 2: Konfigurasikan peringatan Grafana

1. Di panel navigasi sebelah kiri Grafana, pilih > Notification Channels.

2. Pada tab Notification Channels, klik New channel.

   Catatan

   Jika ini pertama kalinya Anda membuat channel, klik Add channel.

3. Pada halaman New Notification Channel, lakukan langkah-langkah berikut.

   1. Masukkan nama peringatan Grafana kustom di bidang Name.

   2. Atur Type menjadi webhook.

   3. Atur URL ke endpoint integrasi yang diperoleh pada Langkah 1.

   4. Di bagian Notification settings, pilih Default, Include image, dan Send reminders. Jika Anda memilih Send reminders, Anda harus mengatur frekuensi pelaporan untuk peringatan yang sama. Frekuensi pelaporan tidak boleh melebihi timeout pemulihan otomatis yang telah Anda atur di Langkah 1.

      Catatan

      Jika Anda tidak memilih Send reminders, sistem hanya akan mengirim satu notifikasi untuk setiap peringatan.

   5. Klik Test untuk memverifikasi koneksi ke ARMS Alert Management.

   6. Setelah pengujian berhasil, klik Save.

(Opsional) Langkah 3: Ubah integrasi

ARMS Alert Management menyediakan pemetaan bidang default antara Grafana dan ARMS. Anda juga dapat menambahkan atau mengubah pemetaan tersebut di halaman Edit Integration sesuai kebutuhan.

Skrip berikut menyediakan contoh sumber peringatan:

{
    "@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"
}

1. Pada tab Alert Integration, temukan integrasi yang ingin Anda kelola dan klik Edit di kolom Actions.

2. Di bagian Event Mapping, klik Send Test Data.

3. Di kotak dialog Send Test Data, masukkan konten JSON dari sumber peringatan Anda, lalu klik Send.

   Catatan

   • Jika muncul pesan Uploaded. No events are generated. Configure mappings based on the original data., artinya bidang sumber peringatan belum dipetakan ke bidang event peringatan ARMS. Data yang dikirim ditampilkan di kotak sebelah kiri sehingga Anda dapat memilih bidang sumber saat mengonfigurasi pemetaan.

   • Jika muncul pesan Uploaded., konten peringatan dilaporkan ke halaman Alert Event History. Untuk informasi lebih lanjut, lihat View alert event history.

   Area teks pada kotak dialog Send Test Data berisi data notifikasi contoh dalam format JSON, dengan bidang seperti @timestamp, orgId, host, ruleName, ruleUrl, state, title, dan panelId. Anda dapat mengklik Copy as cURL command untuk mendapatkan permintaan yang sesuai.

4. Di kotak dialog Send Test Data, klik Disable.

5. Di bagian kiri bagian Event Mapping, klik catatan data yang ingin Anda konfigurasi pemetaannya untuk melihat detailnya.

6. Di panel kanan bagian Event Mapping, konfigurasikan pemetaan antara bidang sumber peringatan dan bidang peringatan ARMS.

   1. Opsi: Di bagian Select Root Node, tentukan apakah akan menggunakan pemrosesan batch.

      Jika data peringatan berisi array, Anda dapat menentukan array tersebut sebagai node root untuk memproses elemennya secara batch.

      Setelah memilih Use Batch Processing, pilih node array yang akan diproses sebagai node root.

      Catatan

      Anda hanya dapat memilih satu array untuk pemrosesan batch.

      Misalnya, dalam contoh peringatan, array evalMatches berisi dua bidang value. Jika Anda memilih evalMatches sebagai node root, ARMS memetakan dua bidang value di bawahnya ke bidang peringatan ARMS yang sama.

      • Jika Anda memilih node root, Anda dapat memetakan nilai atribut $.evalMatches[*].value untuk semua elemen dalam array ke bidang ARMS value secara iteratif.

      • Jika Anda tidak memilih node root, Anda dapat memetakan nilai atribut elemen tertentu dalam array, seperti $.evalMatches[0].value atau $.evalMatches[1].value, ke bidang ARMS value.

   2. Di bagian Map Source Fields to Target Fields, petakan bidang sumber ke bidang peringatan ARMS target.

      Klik ikon pemetaan untuk mengubah metode pemetaan.

      • Direct: Bidang sumber dipetakan langsung ke bidang peringatan ARMS yang sesuai.

      • Series: Menggabungkan beberapa bidang sumber menjadi satu bidang menggunakan pemisah tertentu, lalu memetakan bidang tersebut ke bidang peringatan ARMS. Anda hanya dapat menggunakan karakter khusus sebagai pemisah.

        Misalnya, Anda dapat menggunakan garis bawah (_) untuk menggabungkan bidang $.host dan $.title menjadi $.host_$.title, lalu memetakannya ke bidang ARMS alertname.

      • Condition: Suatu bidang dipetakan hanya jika nilai bidang peringatan memenuhi kondisi tertentu.

      • Mapping table: Mengonfigurasi pemetaan antara tingkat severity sumber peringatan dan ARMS. Metode pemetaan ini hanya diperlukan untuk bidang severity.

      Tabel berikut menjelaskan bidang peringatan ARMS.

      Bidang peringatan	Deskripsi
      alertname	Nama peringatan kustom.
      severity	Tingkat severity peringatan. Anda harus mengonfigurasi pemetaan untuk bidang ini. Metode pemetaan harus diatur ke Direct.
      message	Deskripsi peringatan. Deskripsi ini digunakan sebagai konten pesan peringatan. Panjang deskripsi tidak boleh melebihi 15.000 karakter.
      value	Nilai contoh metrik.
      imageUrl	URL grafik garis yang berisi metrik Grafana. URL ini digunakan untuk memetakan grafik garis.
      check	Item pemeriksaan peringatan. Contoh: CPU, JVM, Application Crash, dan Deployment.
      source	Sumber peringatan.
      class	Jenis objek yang memicu event peringatan, misalnya host.
      service	Layanan sumber peringatan. Contoh: Login Service.
      startat	Timestamp yang menunjukkan waktu mulai event.
      endat	Timestamp yang menunjukkan waktu akhir event.
      generatorUrl	URL detail event.

      Pada halaman Event Mapping, klik Send Test Data untuk memverifikasi ingesti data. Bagian Latest 10 Data Entries menampilkan data sumber yang diterima beserta statusnya. Perluas entri data untuk melihat struktur JSON-nya, yang mencakup bidang seperti @timestamp, orgId, host, dan ruleName. Di panel kanan, Anda dapat memetakan bidang sumber ini ke bidang peringatan ARMS yang sesuai.

7. Konfigurasikan bidang deduplikasi untuk event peringatan.

   Untuk mengurangi data duplikat, sistem menggunakan bidang terkait sebagai kriteria deduplikasi. ARMS Alert Management memungkinkan Anda melihat pratinjau hasil pengelompokan deduplikasi data event historis di area Event Mapping. Anda dapat menyesuaikan bidang deduplikasi sesuai kebutuhan.

   Catatan

   Deduplikasi event hanya berlaku untuk event yang belum terselesaikan.

   1. Di bagian Event Deduplication pada halaman Edit Integration, pilih bidang untuk deduplikasi.

      Ketika beberapa event memiliki nilai yang sama untuk bidang yang dipilih, event tersebut akan digabung menjadi satu peringatan.

      Misalnya, jika Anda menetapkan bidang ARMS metric dan ruleName sebagai kunci deduplikasi, event dari sumber Grafana yang memiliki metrik dan nama aturan yang sama akan digabung menjadi satu event. Event dengan nilai berbeda tetap terpisah.

   2. Klik Deduplication Test untuk melihat pratinjau pengelompokan peringatan setelah deduplikasi.

      Catatan

      Pengujian deduplikasi dijalankan pada 10 entri data uji terakhir yang diunggah di panel kiri bagian Event Mapping.

      Pilih metric dan ruleName sebagai bidang deduplikasi lalu klik Deduplication Test. Sistem akan mengelompokkan event berdasarkan bidang yang dipilih. Event dengan metrik dan nama aturan yang sama dikelompokkan bersama. Hasil pengelompokan ditampilkan dalam tabel yang mencakup kolom seperti alertname, value, severity, startat, endat, dan message.

8. Setelah menyelesaikan konfigurasi, klik Save.

Lihat detail event peringatan

1. Di panel navigasi sebelah kiri Konsol ARMS, pilih Alert Management > Alert Event History.

2. Pada halaman Alert Event History, klik nama event peringatan untuk melihat detail event tersebut. Untuk informasi lebih lanjut, lihat View alert event history.

Kelola integrasi

Di panel navigasi sebelah kiri, pilih Alert Management > Integrations. Pada tab Alert Integration, Anda dapat melakukan operasi berikut pada integrasi yang telah Anda buat:

• Lihat detail integrasi: Temukan integrasi lalu klik barisnya. Di halaman Integration Details, lihat detail integrasi.

• Perbarui kunci: Untuk mengubah kunci integrasi, temukan integrasi, pilih More > Update Key di kolom Actions, lalu klik Confirm di kotak dialog yang muncul.

  Penting

  Setelah memperbarui kunci, Anda juga harus memperbarui URL yang dikonfigurasi di Langkah 2 dengan endpoint integrasi baru.

• Ubah integrasi: Temukan integrasi lalu klik Edit di kolom Actions. Di halaman Integration Details, ubah informasi integrasi lalu klik Save.

• Aktifkan atau nonaktifkan integrasi: Temukan integrasi lalu klik Disable atau Enable di kolom Actions.

• Hapus integrasi: Temukan integrasi lalu klik Delete di kolom Actions. Di pesan yang muncul, klik OK.

• Tambahkan alur pemrosesan event ke integrasi: Temukan integrasi dan klik Add Event Processing Flow di kolom Actions. Untuk informasi lebih lanjut, lihat Event processing flow.

• Buat kebijakan notifikasi: Temukan integrasi yang ingin Anda buat kebijakan notifikasinya, lalu klik More di kolom Actions. Di daftar yang muncul, klik Create Notification Policy. Untuk informasi lebih lanjut, lihat Notification policies.