Application Real-Time Monitoring Service:Nagios と ARMS の統合

アラート通知スクリプトの作成

1. Nagios サーバーにログインし、プラグインディレクトリに移動します。

   cd /usr/local/nagios/libexec/

2. 以下の内容で nagios-alert.py という名前のファイルを作成します。

   重要

   <your-integration-url> は、ステップ 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>"  # Replace with the integration address from Step 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. まだインストールされていない場合は、requests ライブラリをインストールします。

   pip install requests

Nagios コマンドの定義

1. Nagios コマンド構成ファイルを開きます。

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

2. ファイルに以下のコマンド定義を追加します。

   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. ファイルを保存して閉じます。

連絡先の通知コマンドの更新

1. Nagios 連絡先構成ファイルを開きます。

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

2. 連絡先定義内で、以下の通知コマンドディレクティブを追加または更新します。

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

   

3. ファイルを保存して閉じます。

Nagios の再起動

変更を適用するには、次のコマンドを実行します。

systemctl restart nagios

テストデータの送信

1. アラート統合 タブで、対象の統合を見つけ、操作 列の 編集 をクリックします。

2. イベントマッピング セクションで、テストデータの送信 をクリックします。

3. テストデータの送信 ダイアログボックスで、JSON アラートペイロードを貼り付け、送信 をクリックします。

   説明

   • 「アップロードされました。イベントは生成されていません。元データに基づいてマッピングを構成してください。」というメッセージが表示された場合、ソースフィールドはまだマッピングされていません。アップロードされたデータは左側のペインに表示され、マッピング構成時にフィールドを選択できます。

   • 「Uploaded.」というメッセージが表示された場合、アラート内容が[アラートイベント履歴]ページに報告されました。 詳細については、「過去のアラートイベントの表示」をご参照ください。

4. テストデータの送信 ダイアログボックスで、無効化 をクリックします。

フィールドマッピングの構成

1. イベントマッピング セクションの左側ペインで、データレコードをクリックして詳細を表示します。

2. （オプション）ルートノードの選択 セクションで、アラートデータに配列ノードが含まれる場合はバッチ処理を有効にします。バッチ処理に使用する配列ノードを選択すると、そのノード配下のデータが一括で処理されます。

   説明

   アラートデータに複数の配列ノードが存在する場合、バッチ処理用に選択できるのは 1 つのみです。

3. ソースフィールドからターゲットフィールドへのマッピング セクションで、ソースフィールドを ARMS アラートフィールドにマッピングします。マップ アイコンをクリックしてマッピング方法を選択します。

   • 直接 — 単一のソースフィールドを ARMS アラートフィールドにマッピングします。

   • [シリーズ] -- 複数のソースフィールドをデリミタ（特殊文字のみ）で連結し、その結果を ARMS アラートフィールドにマップします。

   • 条件 — 指定された条件を満たす場合にのみ、ソースフィールドを ARMS アラートフィールドにマッピングします。

   • マッピングテーブル — アラートソースの重大度レベルを ARMS の重大度レベルにマッピングします。この方法は severity フィールドにのみ使用します。

イベント重複排除の構成

イベント重複排除は、指定されたフィールドの値が同一である複数のイベントを単一のアラート通知にマージすることで、ノイズを低減します。

1. 統合詳細 ページの イベント重複排除 セクションで、重複排除に使用するフィールドを選択します。

2. 重複排除テスト をクリックして、グループ化結果をプレビューします。

   説明

   重複排除テストは、イベントマッピング セクションでアップロードされた最新のデータレコード 10 件に対して実行されます。

3. 保存 をクリックします。