Configuring Nagios XI as an event source

Nagios XI provides network monitoring products. You can set up an in integration with Netcool® Operations Insight® to receive alert information from Nagios XI products.

Before you begin

The following event types are supported for this integration:
  • Service Notifications
  • Host Notifications

About this task

Using a package of configuration files provided by event management, you set up an integration with Nagios XI. The alerts generated by Nagios XI are sent to the event management service as events.

Note: Event management supports integration with the server monitoring and web monitoring components of the Nagios XI product.

Procedure

  1. Ensure that the Nagios Plugins are installed into your instance of Nagios XI. Depending on how the plugins are controlled, you can check their status as follows:
    • If you use xinetd for controlling the plugins: service xinetd status
    • If you use a dedicated daemon for controlling the plugins:service nrpe status
  2. Click Administration > Integrations with other systems.
  3. Click New integration.
  4. Go to the Nagios XI tile and click Configure.
  5. Enter a name for the integration.
  6. Click Download file to download the nagios-cem.zip file. The compressed file contains three files to set up the integration with event management:
    • The file cem.cfg needs to be imported into Nagios XI.
    • The file nagios-cem-webhook.sh includes the unique webhook URL generated for this integration.
    • The file import-cem.sh copies the cem.cfg and nagios-cem-webhook.sh files to Nagios XI destination directory.
    Important: The download file contains credential information and should be stored in a secure location.
  7. Click Save to save the integration in event management.
  8. Extract the files to any directory, and copy the files to the Nagios XI server.
  9. Run the import-cem.sh command to copy the cem.cfg and nagios-cem-webhook.sh files to the correct Nagios XI destination directory.

    For example, if you are logged in as a non-root user, run the command as follows to ensure it runs as root and copies the files as required: sudo bash ./import-cem.sh.

  10. Log in to the Nagios XI UI as an administrator, and use the Core Config Manager to import the cem.cfg file:
    1. Go to Configure in the menu bar in the window and select Core Config Manager from the list.
    2. Select Tools > Import Config Files from the menu in the window.
    3. Select cem.cfg and click Import.
  11. Enable the environment variable macro:
    1. In Core Config Manager, select CCM Admin > Core Configs from the menu in the window.
    2. On the General tab, enter 1 for the enable_environment_macros parameter.
    3. Click Save Changes.
  12. Ensure the cemwebhook contact is added to the set of hosts and services you monitor:
    Note: Remember to enable the cemwebhook contact when setting up a source to monitor. To enable the cemwebhook contact for the host and all services for that host, ensure you select CEM Webhook-Contact under Send Alert notification To in Step 4 of the Configuration Wizard.

    To check that cemwebhook is among the contacts included in alerts for a host:

    1. In Core Config Manager, select Monitoring > Hosts from the menu in the window.
    2. Click a hostname to edit its settings.
    3. Click the Alert Settings tab and then click Manage Contacts.
    4. Ensure that cemwebhook is in the Assigned column. If not, then select it and click Add Selected.
    5. Click Close and then Save.
    Note: This example is for checking host settings, but the same steps can be followed to check services.
  13. Change the command type for the notify-cem-host and notify-cem-service commands:
    1. In Core Config Manager, select Commands > _Commands from the menu in the window.
    2. Locate and click notify-cem-host to edit its settings.
    3. Select misc command from the Command Type list.
    4. Click Save.
    5. Repeat for notify-cem-service.
  14. Select Quick Tools > Apply Configuration from the menu in the window and click Apply Configuration.
  15. To start receiving alert information from Nagios XI, verify that Enable event management from this source is set to On..