With this integration, get trigger alerts from Nagios XI and have them converted to incidents within Freshservice so you can find quicker resolutions to critical issues.


Prerequisites: Customers should have an active account in Freshservice with AMS feature enabled.


To receive alert payloads you’ll need to add two new commands - a service level notification and a host-level notification. This can be achieved by executing a curl request. 


Step 1: To add commands

  1. Access your Nagios XI account. 

  2. Click on the Configuration tab and select Core Config Manager

  3. Click on the Commands dropdown in the left pane. 

  4. Select >_Commands

  5. Click the +Add New button. The Command Management page will appear. 

  6. Enter a Command Name and Command Line in their respective field boxes. 

  7. Click the Command Type dropdown. 

  8. Select misc command

  9. Mark the checkbox as Active
    Note: Marking the checkbox as Active will make the objects active by writing them to the configuration files. This will make them appear on Nagios.

  10. Click Save

Examples of Command Name and Command Line:


alert-service-notification-to-freshservice:

curl -X POST -H "Authorization: auth-key <account_integrationkey>"-H "Content-Type: application/json" --data "{\"resource\": \"$SERVICEDESC$\", \"hostname\": \"$HOSTNAME$\", \"message\": \"$NOTIFICATIONTYPE$ - $SERVICEDESC$\", \"description\": \"$SERVICEDESC$\", \"ip_address\": \"$HOSTADDRESS$\", \"severity\": \"$SERVICESTATE$\", \"mo_name\": \"$HOSTNAME$\"}" https://subdomain.alerts.freshservice.com/alerts

alert-host-notification-to-freshservice:

curl -X POST -H "Authorization: auth-key <account_integrationkey>" -H "Content-Type: application/json" --data "{\"resource\": \"$HOSTNAME$\", \"hostname\": \"$HOSTNAME$\", \"message\": \"$NOTIFICATIONTYPE$ - $HOSTNAME$ is $HOSTSTATE$\", \"ip_address\": \"$HOSTADDRESS$\", \"severity\": \"$HOSTSTATE$\", \"mo_name\": \"$HOSTNAME$\"}" https://subdomain.alerts.freshservice.com/alerts


Note: The auth-key (account_integrationkey) is unique to your respective Freshservice Accounts. You can obtain this key from your Account Details page in Freshservice. 



Note: Based on your requirements you can add tags, alert_group_key or any other additional attributes in the payload.


Step 2: To create contact groups

  1. Access your Nagios XI account. 

  2. Click on the Configuration tab and select Core Config Manager.

  3. Click on the Alerting dropdown in the left pane. 

  4. Select Contact Groups

  5. Click the +Add New button. The Contact Group Management page will open. 

  6. Enter a Contact Group Name and provide a Description

  7. Mark the checkbox as Active.

  8. Click Save


Step 3: To add contacts

  1. Access your Nagios XI account. 

  2. Click on the Configuration tab and select Core Config Manager.

  3. Click on the Alerting dropdown in the left pane. 

  4. Select Contacts

  5. Click the +Add New button. The Contact Management page will open and by default, the Common Settings tab will be selected. 

  6. To configure Common Settings:

    1. Provide a Contact Name

    2. (Optional) You can also enter a Description and Email Address

    3. Mark the checkbox as Active

  7. Click Manage Contacts Group.

  8. Select the Contact Group created during Step 2. 

  9. Click the Add Selected button and click Close.  

  10. Select the Alert Settings tab. 

  11. To configure Alert Settings

    1. Enable the Host Notifications and Service Notifications by clicking the On tab.  

    2. Click the Host Notifications Timeperiod dropdown and select 24x7.

    3. Click the Service Notifications Timeperiod dropdown and select 24x7

    4. Enable the Host Notifications options and Service Notifications options according to your preferences. 

  12. Click Manage Host Notifications Commands. A pop-up window will open.

  13. Select the host notification Command created during Step 1.

  14. Click the Add Selected button once you’re done selecting host commands.

  15. Click Close once you’re done. 

  16. Click Manage Service Notifications Commands. A pop-up window will open.

  17. Select the service notification Command created during Step 1. 

  18. Click the Add Selected button once you’re done selecting service commands.

  19. Click Close once you’re done.

  20. (Optional) Enable options for Retain status information, Retain non-status information, and Can Submit Commands

  21. Click Save to finalize changes.