Application Real-Time Monitoring Service：Integrasi Zabbix dengan ARMS

Prasyarat

Hanya mendukung Zabbix versi 5.x.

Langkah 1: Buat integrasi Zabbix

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

2. Pada tab Alert Integration, klik Zabbix.

3. Di kotak dialog Create Zabbix Integration, masukkan nama dan deskripsi integrasi, tentukan waktu pemulihan otomatis untuk peristiwa peringatan, lalu klik Save.

   Catatan

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

4. Pada tab Alert Integration, temukan integrasi Zabbix yang telah dibuat dan salin URL pada kolom Alamat Integrasi.

   

Langkah 2: Konfigurasi Zabbix

1. Masuk ke server tempat Zabbix diterapkan dan jalankan perintah berikut untuk menemukan jalur skrip Zabbix:

   cat /etc/zabbix/zabbix_server.conf | grep alert

   Contoh respons:

   

2. Jalankan perintah cd untuk masuk ke direktori skrip Zabbix.

3. Jalankan perintah berikut untuk mengunduh paket instalasi modul manajemen peringatan ARMS:

   wget http://arms-public.oss-cn-shanghai.aliyuncs.com/alerts/aliyunalertmanager.tgz

4. Jalankan perintah berikut untuk mengekstrak paket instalasi:

   tar -xzvf aliyunalertmanager.tgz

5. Masuk ke direktori bin:

   cd aliyunalertmanager/bin

6. Jalankan perintah berikut untuk menginstal modul manajemen peringatan:

   sh install.sh {URL of the Zabbix integration}

   Dalam perintah sebelumnya, ganti {URL of the Zabbix integration} dengan URL yang Anda dapatkan di Langkah 1.

7. Selama instalasi, masukkan URL login Zabbix, nama pengguna administrator, dan kata sandi administrator sesuai petunjuk.

(Opsional) Langkah 3: Modifikasi integrasi

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

Contoh sumber peringatan:

{
    "startat":"2021.09.09 20:13:57",
    "eventId":"16874-9756",
    "eventType":"trigger",
    "message":"/: Ruang terpakai di server Zabbix adalah 81 GB, memicu alarm penggunaan disk",
    "hostname":"Server Zabbix",
    "ip":"127.0.0.1",
    "severity":"Peringatan",
    "value":"81 GB",
    "metric":"vfs.fs.size[/,used]",
    "itemName":"/: Ruang terpakai",
    "alertname":"pemicu penggunaan disk",
    "eventUrl":"http://127.0.0.1/zabbix/tr_events.php?triggerid=16874&eventid=9756"
}

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 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 di 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 Anda memilih Gunakan Pemrosesan Batch, pilih node array yang akan diproses batch sebagai node root.

      Catatan

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

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

      Klik ikon pemetaan untuk mengubah metode pemetaan bidang.

      • Langsung: Bidang tertentu dari sumber peringatan dipetakan langsung ke bidang peringatan ARMS yang ditentukan.

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

      • Kondisional: Bidang sumber peringatan yang ditentukan dipetakan ke bidang peringatan ARMS hanya jika nilai bidang memenuhi kondisi yang ditentukan.

      • Tabel pemetaan: Tingkat keparahan sumber peringatan dipetakan ke tingkat keparahan peringatan ARMS. Tabel pemetaan hanya berisi 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 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 Login.
      startat	Cap waktu yang mewakili waktu mulai peristiwa.
      endat	Cap waktu yang mewakili waktu akhir peristiwa.
      generatorUrl	URL detail peristiwa.

7. Konfigurasikan deduplikasi bidang untuk peristiwa peringatan.

   Untuk mengurangi data duplikat, sistem menggunakan bidang relevan sebagai dasar deduplikasi. Manajemen Peringatan ARMS 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 di halaman Integration Details, pilih bidang yang digunakan untuk deduplikasi.

      Jika beberapa peristiwa memiliki nilai yang sama untuk bidang tertentu, peristiwa tersebut digabungkan menjadi satu notifikasi peringatan.

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

      Catatan

      Uji deduplikasi hanya berlaku untuk 10 catatan data terbaru yang diunggah di bagian kiri Event Mapping.

8. Setelah Anda mengonfigurasi pengaturan, klik Save.

Verifikasi hasil

Lakukan operasi berikut untuk memeriksa apakah modul manajemen peringatan telah diinstal:

1. Masuk ke konsol Zabbix.

2. Di bilah navigasi atas, pilih Administration > Users.

   Di halaman Users, periksa keberadaan pengguna bernama Aliyun Alert User.

3. Di bilah navigasi atas, pilih Administration > User groups.

   Di halaman User groups, periksa apakah grup pengguna bernama Aliyun Alert Group tersedia dan apakah anggota bernama Aliyun Alert User termasuk dalam grup pengguna tersebut.

4. Di bilah navigasi atas, pilih Administration > Media types.

   Di halaman Media types, periksa keberadaan jenis media bernama Aliyun Alert Media.

5. Di bilah navigasi atas, pilih Configuration > Actions.

   Di halaman Actions, periksa keberadaan tindakan bernama Aliyun Alert Action.

   Catatan

   Anda dapat menentukan konten kustom yang akan dilaporkan dalam tindakan Aliyun Alert Action berdasarkan kebutuhan bisnis Anda.

Lihat detail tentang peristiwa peringatan

1. Di panel navigasi sebelah 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 sebelah kiri, pilih Alert Management > Integrations. Pada tab Alert Integration, Anda dapat melakukan operasi berikut pada integrasi yang telah dibuat:

• Lihat detail integrasi: Temukan integrasi lalu klik barisnya. 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 kunci diperbarui, instal ulang modul manajemen peringatan berdasarkan informasi di Langkah 2.

• 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 untuk mana Anda ingin membuat kebijakan notifikasi, dan klik Lainnya di kolom Actions. Dalam daftar yang muncul, klik Create Notification Policy. Untuk informasi lebih lanjut, lihat Buat dan kelola kebijakan notifikasi.