Nagios is a free and open source computer-software application that monitors systems, networks and infrastructure. Nagios offers monitoring and alerting services for servers, switches, applications and services.

What can Xurrent IMR do for Nagios users?

With the Nagios integration, alerts are sent from Nagios Core, which is ingested by Xurrent IMR, alerting the right team and notifying them based on on-call schedules via email, text messages(SMS), phone calls(Voice), Slack, Microsoft Teams and iOS & Android push notifications, and escalates alerts until the alert is acknowledged or closed.

You can also use Alert Rules to custom route specific Nagios Core alerts to specific users, teams or escalation policies, write suppression rules, auto add notes, responders and incident tasks.

To integrate Nagios with Xurrent IMR, complete the following steps:

On the Xurrent IMR Dashboard:

1. To add a new Nagios integration, go to Teams on Xurrent IMR and click on the team you want to add the integration to.
2. Next, go to Services and click on the relevant Service.
3. Go to Integrations and then Add New Integration. Give it a name and select the application Nagios from the dropdown menu.
4. Go to Configure under your Integrations and copy the Webhook URL generated.

In Nagios:

1. Install Nagios Core on your system. After this, add an integration on your Xurrent IMR account. Note the integration key automatically provided to you.
2. [IMPORTANT]: Make sure you have Python2 installed on your system.
3. [IMPORTANT]: If you are using Python3, in the below step change the URL to https://github.com/Zenduty/zd-nagios-python3.git
4. Download the Xurrent IMR-Nagios files by following the steps given below:
5. Open Xurrent IMR_nagios.cfg file and enter the integration key provided into the “pager” field. In the two command_line fields below, modify the path to the Xurrent IMR_nagios.py to wherever your Nagios plugin folder resides. You will move the Xurrent IMR_nagios file to this folder in step 11.
6. Move the Nagios Core configuration file into place.
   • For Debian-based systems this is usually /etc/nagios3/conf.d:
   • For RHEL-based systems this is usually /etc/nagios:
   • For source installations, move the file to /usr/local/nagios/etc/objects:
7. Skip this step if you are using a Debian-based distribution. If you are using a RHEL-based distribution, you will need to edit the Nagios Core config to load the Xurrent IMR config. To do this, open /etc/nagios/nagios.cfg and add this line to the file:
8. If using a source installation, add this line to the main config file at /usr/local/nagios/etc/nagios.cfg
9. Add the contact “Xurrent IMR” to your Nagios Core configuration’s main contact group. If you’re using the default configuration, open /etc/nagios3/conf.d/contacts_nagios2.cfg (onDebian-based systems) or /etc/nagios/objects/contacts.cfg (on RHEL-based systems) or/usr/local/nagios/etc/objects/contacts.cfg (for source installations) and look for the “admins” contact group. Then, simply add the “Xurrent IMR” contact
10. Move zenduty_nagios.py to the Nagios plugin folder.
    • For Debian-based systems this is usually /usr/lib/cgi-bin/nagios3/:
    • For most RHEL-based systems this is usually /usr/lib64/nagios/cgi/:
    • For Amazon Linux & CentOS 6+ systems this is usually /usr/local/nagios/sbin:
11. Make the zenduty_nagios.py file executable.
    • For Debian-based systems:
    • For most RHEL-based systems:
    • For Amazon Linux and CentOS 6+ systems:
12. Restart nagios service and your Xurrent IMR integration is finished!