Nagios Listener
Description
The Nagios listener collects alarms and metrics incoming from Nagios and sends the output to 1Gateway.
Prerequisites
- Get the API key by clicking on the user avatar in Nagios or by going to {+}http://nagios-server/nagiosxi/account/+
. This will show the account information, including the API key.
Image 2. Nagios account information, including the API key.
Installation
Make sure you have the 1gateway zip file that includes the plugin files and valid licences information ready. This file has been provided to you with the installation files.
1 - Login
Login to 1gateway, and make sure you are in "Advanced mode". If this is the first time you log in, the default user and password are both 'admin' (without the quotes).
2 - System Maintenance
Click on the menu icon and choose the option "System maintenance"
3 - Upload file
In the System maintenance view you can either drag and drop the downloaded zip file or select it by clicking the "choose file" button.
4 - Restart
After the upload installation will be confirmed. Restart 1Gateway to ensure any locked files are updated.
Configuration
Open the main menu and click on "New plugin"
Select the plugin you want to configure. Use the Filter field if needed.
The basic configuration includes these fields:
Field name | Supported values | Description |
|---|---|---|
IP address | Valid ip address | Nagios server |
API key | Valid API key | Nagios API key |
interval | Any integer | Polling interval in seconds (default is 300) |
Advanced configuration
The advanced configuration of the Nagios listener plugin includes the message type configuration. This message type is used in the from field in the mappers used to convert the messages incoming from Nagios into normalized metrics. It is useful for custom mappers with a different message type.
See also