*Version: 1.0 | Last Updated: 15/10/2024* ## Overview - **Integration Name:** Nagios - **Purpose:** Fetching data from Nagios to MoovingON AI - **Audience:** DevOps, Support team, TAM - **Prerequisites:** Administrator role in MoovingON AI and Nagios --- ## Table of Contents - [[#Setup Instructions]] - [[#Configuration]] - [[#Related Links]] --- ## Setup Instructions` First, we’ll have to add a new Incoming API Integration: **Navigate to Settings >> Integrations** **** Select the relevant customer, then click Add Webhook, choose a name then Submit **** Next, we’ll copy the Username and Password so we’ll be able to use them during Nagios Configuration **** --- ## Configuration **Nagios Configuration:** 1. **Connect to the Nagios XI server by using an SSH client.** 2. **Log in using the root user:** **** 3. **Download the latest version of the script:** **** 4. **Extract it to Nagios’s libexec directory:** **** 5. **Create a config file by making a copy of setting.conf.bak** **** 6. **Set Nagios user to be the owner of the MoovingON.AI folder and files (it’s essential so Nagios itself will be able to run the script. There’s more information about it in the troubleshooting section).** **** 7. **Edit the config file and add the Username and Password that we’ve got from MoovingON AI:** **Example:** ** **** 8. **We should set push-to-xiteit.sh to run every 15 seconds by using cron:** **(It might be necessary to install Crontab.)** **** Copy the following:** **** **And save** 9. **Now we should log in to the web interface of Nagios. Go to Configure >> Core Config Manager** **** 10. **On the menu, click on Commands and then Add New.** **** 11. **We will add 2 commands. One for Services and one for Hosts.       For the Service, we’ll copy this to the Command Line field:**       ****             **For the Host, we would use this:**       ****       ****             12. **To use these commands, we’ll have to assign them to a contact by going to Contacts and clicking on Nagios Admin (Alternatively, we can create a new contact and assign it to specific alerts).** **** 13. **Switch to the Alert Settings tab, set the following:** **** **Notification options should be set according to the user's preferences.** 14. **We’ll click on Manage Host Notifications Commands and add our custom add-host-to-queue command to Assigned:** **** **We can click Close afterwards** 15. **Likewise, we’ll click on Manage Service Notification Commands and add our custom add-service-to-queue command to Assigned** 16. **That’s it. Every time a new alert changes severity in Nagios XI, a new event will pop up on MoovingON AI** #### Recovery **Nagios alerts with severity OK will not get recovered by default unless we do the following steps:** 1. **Go to Settings >> Templates** 2. **Select the default template that we’ve made when we added an Incoming API integration.****Select the default template that we’ve made when we added an Incoming API integration.** 3. **Click on Fields and set the Recovery field to fetch from severity that contains “OK”** **** **We can now click the save button.** --- ## Related Links - **Internal Links:** [[06.08 Templating]], [[04.15 Webhook]] - **External Resources:** [Nagios Documentation](https://www.nagios.org/documentation/)