Skip to main content

Nagios XI

Supported Versions

Type

Authentication Type

4, 5

Agent

Bearer Token

Nagios XI provides a central view of your entire IT operations network and business processes. Use the BigPanda Agent to connect to Nagios XI, and begin sending alerts directly to BigPanda.

Install the Integration

Administrators can install the integration by following the instructions to install for your chosen agent tool:

For Nagios XI and Nagios Logs - Do not follow the standard configuration step, but follow the XI and Logs specific configuration.

Configure Nagios XI

Follow these steps instead of the in-app configuration instructions for Nagios.

Create BigPanda Notification Commands

  1. In the Nagios XI console, go to Configure > Core Config Manager from the top menu.

  2. Go to Commands > _ Commands from the side menu.

  3. Select the Add New button.

  4. In the Command Name field, enter notify-host-by-bigpanda.

  5. In the Command Line field, enter:

    /usr/bin/bigpanda-notification HOSTOUTPUT="$HOSTOUTPUT$" HOSTSTATE="$HOSTSTATE$" HOSTNAME="$HOSTNAME$" HOSTGROUPNAMES="$HOSTGROUPNAMES$" LASTSERVICESTATECHANGE="$LASTSERVICECHECK$" LASTHOSTSTATECHANGE="$LASTHOSTCHECK$" LONGSERVICEOUTPUT="$LONGSERVICEOUTPUT$" LONGHOSTOUTPUT="$LONGHOSTOUTPUT$" NOTIFICATIONTYPE="$NOTIFICATIONTYPE$" SERVICEOUTPUT="$SERVICEOUTPUT$" SERVICEDESC="$SERVICEDESC$" SERVICESTATE="$SERVICESTATE$" SERVICEGROUPNAMES="$SERVICEGROUPNAMES$"

  6. In the Command Type dropdown, select misc command.

  7. Select Save.

Create a second, new command

  1. Select the Add New button.

  2. In the Command Name field, enter notify-service-by-bigpanda.

  3. In the Command Line field, enter:

    /usr/bin/bigpanda-notification HOSTOUTPUT="$HOSTOUTPUT$" HOSTSTATE="$HOSTSTATE$" HOSTNAME="$HOSTNAME$" HOSTGROUPNAMES="$HOSTGROUPNAMES$" LASTSERVICESTATECHANGE="$LASTSERVICESTATECHANGE$" LASTHOSTSTATECHANGE="$LASTHOSTSTATECHANGE$" LONGSERVICEOUTPUT="$LONGSERVICEOUTPUT$" LONGHOSTOUTPUT="$LONGHOSTOUTPUT$" NOTIFICATIONTYPE="$NOTIFICATIONTYPE$" SERVICEOUTPUT="$SERVICEOUTPUT$" SERVICEDESC="$SERVICEDESC$" SERVICESTATE="$SERVICESTATE$" SERVICEGROUPNAMES="$SERVICEGROUPNAMES$"

  4. In the Command Type dropdown, select misc command.

  5. Select Save.

Apply the configuration

After creating the two commands, select the Apply Configuration button on the Commands page.

https://files.readme.io/abae584-applyconfig.png

Create a BigPanda Group and Contact

Create a BigPanda Group.

  1. While still under the Core Config Manager page, go to Alerting > Contact Groups from the side menu.

  2. Select the Add New button.

  3. In the Contact Group Name field, enter bigpanda.

  4. In the Description field, enter Send Alerts to BigPanda.

  5. Click Save.

  6. After creating the Contact Group, select Apply Configuration.

Create a BigPanda Contact

  1. From the side menu, go to Alerting > Contacts.

  2. Select the Add New button.

  3. In the Contact Name field, enter bigpanda.

  4. Optionally, in the Description field, enter a description like Contact for BigPanda.

  5. Select Manage Contact Groups.

  6. Add the bigpanda contact to the Assigned list.

  7. Select the Alert Settings tab at the top.

  8. Set Host Notifications Enabled to On.

  9. Set Host Notifications Timeperiod to 24x7.

  10. Set Host Notifications options to Down, Unreachable, Up, Flapping, and Scheduled Downtime.

  11. Set Service Notifications Enabled to On.

  12. Set Service Notifications Timeperiod to 24x7.

  13. Set Service Notification options to Warning, Unknown, Critical, Flapping, Scheduled Downtime, and Ok.

  14. Select the Manage Host Notifcation Commands button.

  15. Add notify-host-by-bigpanda to the Assigned list.

  16. Select the Manage Service Notification Commands button.

  17. Add notify-service-by-bigpanda to the Assigned list.

  18. Set Can Submit Commands to On.

  19. Click Save.

  20. After creating the Contact, select Apply Configuration.

Add BigPanda Contact Group to Template

Next, add BigPanda Contact Group to Template.

Host Template assignment

  1. Go to Templates > Host Templates from the side menu.

  2. Search for the generic-host template.

  3. Select the generic-host template from the search result list.

  4. Select the Alert Settings tab at the top.

  5. Select the Manage Contact Groups button.

  6. Add bigpanda to the Assigned list.

  7. Click Save.

  8. After modifying the Host Template, select Apply Configuration.

Service template assignment

  1. From the side menu, go to Templates > Service Templates.

  2. Search for the generic-service template.

  3. Select the generic-service template from the search result list.

  4. Select the Alert Settings tab at the top.

  5. Select the Manage Contact Groups button.

  6. Add bigpanda to the Assigned list.

  7. Click Save.

  8. After modifying the Service Template, select Apply Configuration.

Uninstall the Integration

Deleting an integration requires changes to both the integrated system and BigPanda. You must uninstall the integration on the integrated system and then delete the integration from BigPanda.

Replacing an existing integration

When replacing an existing integration with a new tool or system, we recommend configuring the new integration first to ensure no data is lost.

Stop Sending Data to BigPanda

On the integrated system, disable any settings that send data to BigPanda.

Manually resolve any open alerts sent from the integration to remove the associated incidents from your incident feed. These incidents will not automatically resolve without an ok status from the original sending integration.

Stop Sending Data from BigPanda

In BigPanda, disable any settings that send data to the integrated system. This includes modifying or removing AutoShare rules or Environments that are tied to the integration.

Delete the Integration from BigPanda

  1. In BigPanda, navigate to the Integrations tab and select the desired integration from the list.

  2. In the integration details on the right of the page, click the trash icon, then confirm you want to delete the integration. The integration will then be removed immediately.

Data removal

This procedure does not remove any data from BigPanda or the integrated system. As needed, remove data from each system before deleting the integration.

In this section: