NrpeMonitor

The NrpeMonitor lets you test plugins and checks running on the Nagios Remote Plugin Executor (NRPE) framework.

Horizon and Nagios have several conceptional differences. In Horizon, a service can only be available or not available and the response time for the service is measured. Nagios, on the other hand, combines service availability, performance data collection, and thresholding in one check command. For this reason, a Nagios check command can have more states than OK and CRITICAL. Using the NrpeMonitor marks all check command results other than OK as DOWN. The full output of the check command output message is passed into the service down event in Horizon.

NRPE configuration on the server is required and the check command has to be configured; for example, command[check_apt]=/usr/lib/nagios/plugins/check_apt
Horizon runs every NRPE check in a Java thread without fork() a process, and is more resource friendly. Nevertheless, it is possible to run NRPE plugins that combine a lot of external programs like sed, awk, or cut. Be aware that each command forks additional processes.

Monitor facts

Class Name

org.opennms.netmgt.poller.monitors.NrpeMonitor

Configuration and use

Table 1. Monitor-specific parameters for the NrpeMonitor
Parameter Description Default

Required

command

The {check_name} of the command configured as command[{check_name}]="/path/to/plugin/check-script

empty

Optional

retry

Number of retries before the service is marked as down.

0

port

Port to access NRPE on the remote server.

5666

padding

Padding for sending the command to the NRPE agent.

2

usessl

Enable encryption of network communication. NRPE uses SSL with anonymous DH and the following cipher suite: TLS_DH_anon_WITH_AES_128_CBC_SHA

true

This monitor implements the Common Configuration Parameters.

Example: Using check_apt with NRPE

This example shows how to configure the NrpeMonitor running the check_apt command on a configured NRPE.

Note that you must include the monitor section in your definition.

Configuration of the NRPE check command on the agent in 'nrpe.cfg'
command[check_apt]=/usr/lib/nagios/plugins/check_apt
Configuration to test the NRPE plugin with the NrpeMonitor
<service name="NRPE-Check-APT" interval="300000" user-defined="false" status="on">
  <parameter key="retry" value="3" />
  <parameter key="timeout" value="3000" />
  <parameter key="port" value="5666" />
  <parameter key="command" value="check_apt" />
  <parameter key="padding" value="2" />
</service>

<monitor service="NRPE-Check-APT" class-name="org.opennms.netmgt.poller.monitors.NrpeMonitor" />