Application Real-Time Monitoring Service：Mengintegrasikan Peringatan Grafana

Langkah 1: Buat integrasi Grafana

1. Masuk ke ARMS Console. Di panel navigasi sisi kiri, pilih Alert Management > Integrations.

2. Di tab Alert Integration, klik Grafana.
3. Di kotak dialog Create Grafana Integration, masukkan nama integrasi, atur waktu pemulihan otomatis untuk peristiwa peringatan, lalu klik Save.
   Catatan

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

4. Di tab Alert Integration, lihat integrasi Grafana yang telah dibuat dan dapatkan titik akhir integrasi.
   

Langkah 2: Konfigurasikan peringatan Grafana

1. Di panel navigasi sisi kiri halaman Grafana, pilih Alerting > Notification channels.
   
2. Di tab Notification channels, klik New channel.
   Catatan Jika Anda membuat saluran untuk pertama kalinya, klik Add channel.

   
3. Di halaman New notification channel, lakukan langkah-langkah berikut:
   1. Masukkan nama peringatan Grafana kustom di bidang Nama.
   2. Atur Tipe menjadi webhook.
   3. Atur URL menjadi titik akhir integrasi yang diperoleh di Langkah 1.
   4. Di bagian Notification settings, pilih Default, Sertakan gambar, dan Kirim pengingat. Setelah memilih Kirim pengingat, atur frekuensi pelaporan peringatan. Frekuensi pelaporan tidak boleh melebihi waktu pemulihan otomatis peristiwa peringatan yang diatur di Langkah 1.
      Catatan Jika Anda tidak memilih Kirim pengingat, setiap peringatan hanya dilaporkan sekali.
   5. Klik Test untuk memeriksa apakah Grafana terhubung ke Manajemen Peringatan.
   6. Setelah uji koneksi berhasil, klik OK.
   

(Opsional) Langkah 3: Modifikasi integrasi

Manajemen Peringatan menyediakan pemetaan bidang antara sumber peringatan Grafana dan peristiwa peringatan ARMS. Anda juga dapat menambah atau memodifikasi pemetaan antar bidang di halaman Edit Integration.

Skrip berikut memberikan 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. Di 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 peringatan dari sumber peringatan pihak ketiga dalam format JSON dan klik Send.
   Catatan

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

   • Jika pesan Uploaded. muncul, konten peringatan dilaporkan ke halaman Riwayat Peristiwa Peringatan. Untuk informasi lebih lanjut, lihat Lihat peristiwa peringatan historis.

   

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

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

6. Di bagian kanan Event Mapping, konfigurasikan pemetaan bidang antara sumber peringatan dan ARMS.
   1. Opsional:Di bagian Select Root Node, tentukan apakah akan mengaktifkan pemrosesan batch.
      Jika node array ada dalam data peringatan, Anda dapat menentukan node array sebagai node root. Data yang termasuk dalam node root diproses secara batch.

      Setelah memilih Gunakan Pemrosesan Batch, pilih node array yang akan diproses sebagai node root.

      Catatan Jika beberapa node array ada dalam data peringatan, Anda hanya dapat memilih salah satu node array untuk pemrosesan batch.

      Sebagai contoh, node array evalMatches berisi dua bidang value. Jika Anda memilih node array evalMatches sebagai node root, kedua bidang value di bawah node dipetakan ke bidang peringatan ARMS yang ditentukan sebagai bidang yang sama.

      • Jika Anda memilih node array sebagai node root, Anda dapat mengatur nilai atribut $.evalMatches[*].value dari semua elemen dalam array untuk dipetakan secara iteratif ke bidang value ARMS.
      • Jika Anda tidak memilih node array sebagai node root, Anda dapat memetakan secara iteratif nilai atribut $.evalMatches[0].value atau $.evalMatches[1].value dari elemen dengan indeks spesifik dalam array ke bidang value ARMS.
   2. Di bagian Map Source Fields to Target Fields, petakan bidang sumber peringatan ke bidang peringatan ARMS.
      Klik ikon Peta untuk mengubah metode pemetaan bidang.

      • Langsung: Bidang yang ditentukan dari sumber peringatan dipetakan ke bidang peringatan ARMS yang ditentukan.
      • Seri: Anda dapat menggunakan pemisah untuk menggabungkan beberapa bidang dari sumber peringatan menjadi satu bidang, lalu memetakan bidang ini ke bidang peringatan ARMS yang ditentukan. Hanya karakter khusus yang dapat digunakan sebagai pemisah.

        Sebagai contoh, Anda dapat menggunakan garis bawah (_) untuk menggabungkan bidang $.host dan $.title menjadi $.host_$.title lalu memetakan bidang tersebut ke bidang alertname ARMS.

      • Kondisi: Bidang yang ditentukan dari sumber peringatan dipetakan ke bidang peringatan ARMS hanya jika nilai bidang memenuhi kondisi yang ditentukan.
      • Tabel pemetaan: Anda harus mengonfigurasi tabel pemetaan yang memetakan tingkat keparahan sumber peringatan ke tingkat keparahan peringatan ARMS. Anda hanya perlu mengonfigurasi tabel pemetaan untuk bidang keparahan.

      Tabel berikut menjelaskan bidang peringatan ARMS.

      Bidang Peringatan	Deskripsi
      alertname	Nama peringatan kustom.
      severity	Tingkat keparahan peringatan. Anda harus mengonfigurasi pemetaan untuk bidang ini. Metode pemetaan harus diatur ke Langsung.
      message	Deskripsi peringatan. Deskripsi digunakan sebagai isi pesan peringatan. Deskripsi tidak boleh melebihi 15.000 karakter.
      value	Nilai sampel dari data deret waktu.
      imageUrl	URL dari grafik garis yang berisi metrik Grafana. URL digunakan untuk memetakan grafik garis.
      check	Item pemeriksaan peringatan. Contoh: CPU, JVM, Crash Aplikasi, dan Penyebaran.
      source	Sumber peringatan.
      class	Jenis objek yang memicu peristiwa peringatan, misalnya host.
      service	Layanan sumber peringatan. Contoh: Layanan Masuk.
      startat	Cap waktu yang mewakili waktu mulai peristiwa.
      endat	Cap waktu yang mewakili waktu akhir peristiwa.
      generatorUrl	URL dari detail peristiwa.

      
7. Konfigurasikan deduplikasi bidang untuk peristiwa peringatan.
   Untuk mengurangi data duplikat, sistem menggunakan bidang relevan sebagai dasar deduplikasi. Manajemen Peringatan memungkinkan Anda melihat hasil pengelompokan deduplikasi data peristiwa historis yang ditampilkan di bagian Event Mapping. Anda dapat mengubah bidang yang akan dideduplikasi.

   Catatan Anda hanya dapat mengonfigurasi deduplikasi untuk peristiwa yang tidak dihapus.
   1. Di bagian Event Deduplication pada halaman Integration Details, pilih bidang yang digunakan untuk deduplikasi.
      Jika beberapa peristiwa memiliki nilai yang sama untuk bidang yang ditentukan, peristiwa tersebut digabungkan menjadi satu notifikasi peringatan.

      Sebagai contoh, jika Anda menentukan bidang metric dan ruleName ARMS sebagai kunci deduplikasi, peristiwa dengan nilai metric dan ruleName yang sama dalam sumber peringatan Grafana digabungkan menjadi satu peristiwa. Peristiwa dengan nilai metric dan ruleName yang berbeda tetap tidak berubah.

   2. Klik Deduplication Test untuk melihat pratinjau grup peringatan setelah deduplikasi.
      Catatan Tes deduplikasi hanya berlaku untuk 10 catatan data terbaru yang diunggah di bagian kiri Event Mapping.

      
8. Klik Save.

Lihat detail tentang peristiwa peringatan

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

2. Di halaman Alert Event History, klik nama peristiwa peringatan untuk melihat detail peristiwa. Untuk informasi lebih lanjut, lihat Lihat peristiwa peringatan historis.

Kelola integrasi

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

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

• Perbarui kunci: Temukan integrasi Grafana lalu pilih More > Update Key di kolom Actions. Dalam pesan yang muncul, klik OK.
  Penting Setelah memperbarui kunci integrasi Grafana, ubah URL di Langkah 2 menjadi titik akhir integrasi baru.

• Modifikasi integrasi: Temukan integrasi lalu klik Edit di kolom Actions. Di halaman Integration Details, modifikasi 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. Dalam pesan yang muncul, klik OK.

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

• Buat kebijakan notifikasi: Temukan integrasi tempat Anda ingin membuat kebijakan notifikasi, dan klik Lainnya di kolom Actions. Dalam daftar yangmuncul, klik Create Notification Policy. Untuk informasi lebih lanjut, lihat Buat dan kelola kebijakan notifikasi.