Nagios Integration Guide
Nagios is a powerful monitoring system that allows organizations to identify system and networking problems. It has a large open source community who constantly contribute to the development of the system.
TaskCall's Nagios integration brings alerts triggered on Nagios from threshold breaches to be brought to the forefront. Use TaskCall's powerful incident response and management system to resolve incidents in real time. TaskCall's integration supports both Nagios Core (open source software) and Nagios XI (enterprise software).
Nagios requires organizations to set up their own Nagios server, and additional features can be added to the tool by installing plugins. In order to integrate with TaskCall, a plugin needs to be installed and some manual actions need to be taken. Please follow the steps detailed below carefully.
Pointers
- The integration happens between a TaskCall service and Nagios Core or Nagios XI.
- Incidents will automatically resolve in TaskCall when metrics fall back within the normal threshold.
- At the moment this integration only supports alerts to be received from Nagios to TaskCall.
In TaskCall
- Go to Configurations > Services . Select the service you want to integrate with.
- Once you are on the Service details page, go to the Integrations tab. Click on New Integration.
- Give the integration a name.
- From the integration types, select the top radio button indicating that you are trying to use a built-in integration.
- From the list of built-in integrations, select Nagios.
- Click Save.
- Copy the Integration Key that is issued for the integration.
On Nagios Core/Nagios XI Server
- Install the TaskCall Nagios plugin.
curl -s https://api.github.com/repos/taskcallapp/taskcall-nagios/releases/latest | grep '"browser_download_url"' | sed -E 's/.*"([^"]+)".*/\1/' | wget -i-unzip -a taskcall-nagios.zip
- Give execute permission to primary script in TaskCall's plugin.
chmod +x taskcall-nagios/scripts/send_to_taskcall.py
- Nagios can send alerts to endpoints that it defines as contacts. The downloaded plugin contains the TaskCall contact that Nagios uses to send alerts to TaskCall. Some changes need to be made to this file.
Open /{installation path}/taskcall-nagios/taskcall_contact.cfg and replace the <INTEGRATION_KEY> placeholder with the integration key you copied from TaskCall earlier ({installation path} could be /home or whichever parent directory the plugin is installed in). Please ensure that the path to the script is also updated in case you installed the plugin in a different directory from /home.
...
define command {
command_name service-notification-to-taskcall
command_line /home/taskcall-nagios/scripts/send_to_taskcall.py -integKey="<INTEGRATION_KEY>" -entityType=service ... ...
}
define command {
command_name host-notification-to-taskcall
command_line /home/taskcall-nagios/scripts/send_to_taskcall.py -integKey="<INTEGRATION_KEY>" -entityType=host ... ...
}
- Now we need to copy this file to the objects folder in Nagios so it can have access to it.
cp /{installation path}/taskcall-nagios/taskcall_contact.cfg /usr/local/nagios/etc/objects
- We also need to let Nagios know where to look for this new contact. Open the Nagios configuration file from /usr/local/nagios/etc/nagios.cfg and the following line to the file.
cfg_file=/usr/local/nagios/etc/objects/taskcall_contact.cfg
- Now we need to let Nagios know that "taskcall" is a contact that it should send alerts to. We do this by adding "taskcall" as a contact in the main Nagios contacts file located in /usr/local/nagios/etc/objects/contacts.cfg .
...
define contactgroup {
contactgroup_name admins
alias Nagios Administrators
members taskcall
}
...
- Restart the Nagios server. You should start receiving alerts on TaskCall.