Application Real-Time Monitoring Service：Integrasikan Nagios dengan ARMS

Buat skrip notifikasi peringatan

1. Masuk ke server Nagios dan buka direktori plugins:

   cd /usr/local/nagios/libexec/

2. Buat file bernama nagios-alert.py dengan konten berikut:

   Penting

   Ganti <your-integration-url> dengan alamat integrasi yang Anda salin pada Langkah 1.

   #!/usr/bin/python
   # -*- coding: utf-8 -*-
   
   import requests
   import json
   import sys
   import os
   
   headers = {'Content-Type': 'application/json;charset=utf-8'}
   api_url = "<your-integration-url>"  # Ganti dengan alamat integrasi dari Langkah 1
   
   def parse(sys):
       object_type = str(sys.argv[1])
       notification_type = str(sys.argv[2])
       host_name = str(sys.argv[3])
       host_ip = str(sys.argv[4])
       state = str(sys.argv[5])
       time = str(sys.argv[6])
       info = str(sys.argv[7])
   
       if object_type == 'host':
           description = "[{}] {} alert: {} is {}".format(notification_type, object_type, host_name, state)
           service = ""
       else:
           service = str(sys.argv[8])
           description = "[{}] {} alert: {}/{} is {}".format(notification_type, object_type, host_name, service, state)
       content_dict = {'service':""}
       content_dict['object_type'] = object_type
       content_dict['notification_type'] = notification_type
       content_dict['host_name'] = host_name
       content_dict['host_ip'] = host_ip
       content_dict['state'] = state
       content_dict['time'] = time
       content_dict['info'] = info
       content_dict['service'] = service
       content_dict['description'] = description
       print(content_dict)
       return content_dict
   
   
   def msg(text):
       result = requests.post(url=api_url, data=json.dumps(text), headers=headers)
       print(result)
   
   
   if __name__ == '__main__':
       text = parse(sys)
       msg(text)

3. Instal pustaka requests jika belum terinstal:

   pip install requests

Definisikan perintah Nagios

1. Buka file konfigurasi perintah Nagios:

   vim /usr/local/nagios/etc/objects/commands.cf

2. Tambahkan definisi perintah berikut ke dalam file:

   define command{
       command_name notify-host-by-alert
       command_line python /usr/local/nagios/libexec/nagios-alert.py "host" "$NOTIFICATIONTYPE$" "$HOSTALIAS$" "$HOSTADDRESS$" "$HOSTSTATE$" "$LONGDATETIME$" "$HOSTOUTPUT$"
       }
   
   define command{
       command_name notify-service-by-alert
       command_line python /usr/local/nagios/libexec/nagios-alert.py "service" "$NOTIFICATIONTYPE$" "$HOSTALIAS$" "$HOSTADDRESS$" "$SERVICESTATE$" "$LONGDATETIME$" "$SERVICEOUTPUT$" "$SERVICEDESC$"
       }

3. Simpan dan tutup file.

Perbarui perintah notifikasi kontak

1. Buka file konfigurasi kontak Nagios:

   vim /usr/local/nagios/etc/objects/contacts.cfg

2. Tambahkan atau perbarui direktif perintah notifikasi berikut dalam definisi kontak:

   service_notification_commands   notify-service-by-alert
   host_notification_commands      notify-host-by-alert

   

3. Simpan dan tutup file.

Restart Nagios

Jalankan perintah berikut untuk menerapkan perubahan:

systemctl restart nagios

Kirim data uji

1. Pada tab Alert Integration, temukan integrasi tersebut dan klik Edit pada kolom Actions.

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

3. Pada kotak dialog Send Test Data, tempel muatan peringatan JSON dan klik Send.

   Catatan

   • Jika muncul pesan "Uploaded. No events are generated. Configure mappings based on the original data.", artinya bidang sumber belum dipetakan. Data yang diunggah akan ditampilkan di panel kiri agar Anda dapat memilih bidang saat mengonfigurasi pemetaan.

   • Jika muncul pesan "Uploaded.", konten peringatan telah dilaporkan ke halaman Alert Event History. Untuk informasi lebih lanjut, lihat View historical alert events.

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

Konfigurasikan pemetaan bidang

1. Pada panel kiri bagian Event Mapping, klik catatan data untuk melihat detailnya.

2. (Opsional) Pada bagian Select Root Node, aktifkan pemrosesan batch jika data peringatan berisi node array. Pilih node array yang akan digunakan sebagai root node. Sistem akan memproses data di bawah node tersebut secara batch.

   Catatan

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

3. Pada bagian Map Source Fields to Target Fields, petakan bidang sumber ke bidang peringatan ARMS. Klik ikon Map untuk memilih metode pemetaan:

   • Direct — Memetakan satu bidang sumber ke satu bidang peringatan ARMS.

   • Series — Menggabungkan beberapa bidang sumber dengan pembatas (hanya karakter khusus), lalu memetakan hasilnya ke bidang peringatan ARMS.

   • Condition — Memetakan bidang sumber ke bidang peringatan ARMS hanya jika nilainya memenuhi kondisi tertentu.

   • Mapping table — Memetakan tingkat severity dari sumber peringatan ke tingkat severity ARMS. Gunakan metode ini hanya untuk bidang severity.

Konfigurasikan deduplikasi event

Deduplikasi event menggabungkan beberapa event yang memiliki nilai sama pada bidang tertentu menjadi satu notifikasi peringatan, sehingga mengurangi kebisingan.

1. Pada bagian Event Deduplication di halaman Integration Details, pilih bidang yang akan digunakan untuk deduplikasi.

2. Klik Deduplication Test untuk melihat pratinjau hasil pengelompokan.

   Catatan

   Pengujian deduplikasi dijalankan terhadap 10 catatan data terbaru yang diunggah di bagian Event Mapping.

3. Klik Save.