Nagios3 Integration Guide

This integration guide explains how to configure Nagios3 to send alerts to AlertAgility.

  1. First create a new Nagios alert service in your AlertAgility account. create new nagios type service

  2. Attach any escalation policy you want to the newly created Nagios Alert service. Note the service key in this section. It will be used later to configure nagios service to send events to alertagility. edit new nagios type service

  3. Download and install AlertAgility’s Nagios configuration scripts from https://github.com/AlertAgility/alertagility-nagios

        sudo git clone https://github.com/AlertAgility/alertagility-nagios
        
    

  4. Copy the files into Nagios’ configuration directory.

        sudo cp alertagility-nagios.cfg /etc/nagios3/conf.d/
        
    

  5. Open the ‘/etc/nagios3/config.d/alertagility-nagios.cfg’ file and configure the ‘pager’ field by replacing the string ‘INSERT-YOUR-ALERTAGILITY-SERVICE-APIKEY-HERE’ with your Alertagility service API Key.

        pager              INSERT-YOUR-ALERTAGILITY-SERVICE-APIKEY-HERE
        
    

  6. In RHEL based distributions, you will have to update the Nagios config to load the new AlertAgility config file at run time. To do this, open the /etc/nagios3/nagios.cfg file and append the following line to it:

       `cfg_file=/etc/nagios/alertagility_nagios.cfg`
       
    

  7. Note that in the cfg file the command is expecting the python file in /usr/local/bin

       https://github.com/AlertAgility/alertagility-nagios/blob/master/alertagility_nagios.cfg#L15
       
    

  8. Copy the alertagility-nagios.py into /usr/local/bin and ensure that it has the right permissions.

        sudo cp alertagility-nagios.py /usr/local/bin/
        
    

  9. If you are using deafult nagios settings ensure tha alertagility contact is included in your notification. For example on a debian system, contactgroup is defined in /etc/nagios3/conf.d/contacts_nagios2.cfg Notice that alertagility is now included in the admin contact group.

           define contactgroup{
                contactgroup_name       admins
                alias                   Nagios Administrators
                members                 root,alertagility
            }
       
    

  10. Verify Nagios config

        sudo nagios3 -v /etc/nagios3/nagios.cfg
        
    

  11. Restart Nagios service

        sudo service nagios3 restart
        
    

If you encounter any issues, please jump into #alertagility IRC room and we will quickly sort out any issue.