ezeio2:userinterface:manage:destinations:nagios

Nagios integration

About Nagios

Nagios is an open source software designed for monitoring networked systems. While its primary purpose is to monitor the status of computer networks and IT-related services, it can also display information from the ezeio system.

Prerequisites

The Nagios service must allow passive checks using NRDP. Please see the Nagios documentation for details.

https://assets.nagios.com/downloads/nagiosxi/docs/Configuring_Inbound_Checks_With_XI.pdf

The NRDP endpoint must be accessible from the public Internet and the server must have a valid SSL certificate.

ezeio mapping to Nagios hosts/services

The ezeio name (configurable under Configure→System→System Name) will be mapped to the host name in Nagios. Please keep the name short and avoid special characters as those may cause issues in Nagios.

When setting up alarms, the ezeio alarm name (Configure→Alarms→Name) will be mapped to the Nagios Service name, and the action message will be attached to the service status message. Alarms are always given a “critical” status in Nagios, while restore messages are given the “ok” status in Nagios.

When setting up periodic data updates, the ezeio field name (Configure→Fields→Name) will be mapped to the Nagios Service name and the field value will be attached to the service status.

Setting up the Nagios Destination

Navigate to the Destinations tab, and add a destination of type “Nagios NRDP”.

The address shall be the URL of your nagios service, typically ending with “/nrdp/”.

The token is generated from Nagios, and shall be copied as-is.

Don't forget to also create a destination list and add the new destination to it.

Sending alarms/alerts to Nagios

To send an alarm to the Nagios server, simply create an action of the “Send Message” type, and use the destination list with the Nagios destination.

Note that you should also set up a restore action to send the reset message.

Periodically sending data to Nagios

To set up periodic (hourly) updates to Nagios for logging purposes navigate to Configure→System→Export.

Click New Export at the bottom of the screen, and set up an hourly export selecting the Nagios destination.

To select which fields to include in the export, navigate to the field settings and add the tag “NAGIOS” to each field that should be exported. Note that you can add multiple tags to a field, separated by space.

  • ezeio2/userinterface/manage/destinations/nagios.txt
  • Last modified: 2024-09-25 21:37
  • by andreh