Nagios#

Nagios is a Network Monitoring software that you configure from the data of your IT documentation. This way you avoid duplicate data maintenance and minimize errors. The export generates complete or partial configurations -- either manually created or automatically populated with values from i-doit.

Basic configuration#

Set up the configuration under Administration → Import and interfaces → Monitoring → Export configuration

• Local path -- Absolute or relative path where the generated configuration is stored.
• Link to the monitoring tool -- Base link to generate links from i-doit to the monitoring instance.

Base configurations#

Under Add-ons → Nagios the base configurations are created.

This includes the main configuration, service and host templates, and other basic settings. All values are identical to the Nagios configuration.

Configuration in objects#

All other configurations are made within the objects. For host parameters, proceed as follows:

1. Assign via Edit data structure the category folder Nagios (Host) to the desired object types.
2. Enter in the category Host Definition a host definition -- either via a Nagios template or through individual configuration.

Host and service templates follow the Nagios principle. Via the Service assignment category, you assign service checks to a host.

There are two ways to link services with hosts:

1. Direct assignment -- Via the Service assignment category in the host object.
2. Inheritance via software -- In a software object (category Nagios (Applications)) assign a service check. If the software is installed on a host via the Software assignment category, the host automatically inherits the service check.

You can find additional Nagios configurations in objects of the type Persons, Person groups, and Object groups.

Export of the Nagios configuration#

You start the export manually under Administration → Import and interfaces → Monitoring → Export configuration. Select an export configuration and optionally enable validation.

The validation checks basic dependencies -- e.g. whether an IP address is entered for a host. It protects against corrupt configurations but does not offer 100 percent protection. Therefore, always additionally test the generated configuration with the Nagios binary.

The configuration files are stored in the configured path. You can also automate the export via the i-doit console utility (--help shows all options).

CLI console commands and options#

nagios-export#

Exports the Nagios settings and i-doit objects into Nagios configuration files.

Options:

Usage example

1

sudo -u www-data php console.php nagios-export --user admin --password admin --tenantId 1 --nagiosHostId 1

nagios-ndoutils#

Imports monitoring status changes from NDOUtils into the i-doit logbook.

Options:

Usage example

1

sudo -u www-data php console.php nagios-ndoutils --user admin --password admin --tenantId 1

Changelog#