Skip to main content

Linux NRPE3


NRPE (Nagios Remote Plugin Executor) is a protocol that was designed to remotely run monitoring commands.

This Plugin-Pack relies on 3 components that are listed below:

centreon_nrpe3_pluginBinary executablePollerSends a command name and arguments associated to it
centreon_linux_local.plPerl ScriptMonitored hostIs run locally and returns a status, an output message and metrics
centreon-nrpe3Service/daemonMonitored hostListens on port 5666 and runs the configured commands on demand

Plugin-Pack assets​

Monitored objects​

  • CentOS 7 / RHEL7 Linux servers (to which this procedure applies)
  • Other GNU/Linux distributions, provided that the plugin and the daemon are installed and configured manually)

Collected metrics​

Only standard metrics are described in this section. Be aware that a lot of other checks and metrics are available from the Plugin. Here is a non-exhaustive list:

  • Cmd-Generic : Check command returns
  • Connections-Generic : Check tcp/udp connections
  • Cpu-Detailed : Check average usage for each CPUs (User, Nice, System, Idle, Wait, Interrupt, SoftIRQ, Steal, Guest, GuestNice)
  • Disk-Generic-Name : Check storage usage (single partition)
  • Disk-Global : Check storage usage (all partitions or filtered with regexp)
  • Disk-IO-Generic-Name : Check some disk io counters (single partition)
  • Disk-IO-Global : Check some disk io counters (all partitions or filtered with regexp)
  • File-Date-Generic : Check time (modified, creation,...) of files/directories
  • File-Size-Generic : Check size of files/directories
  • Inodes-Generic-Name : Check Inodes space usage (single partition)
  • Inodes-Global : Check Inodes space usage (all partitions or filtered with regexp)
  • Is-File-Generic : Check the presence of a file
  • Is-Not-File-Generic : Check the absence of a file
  • Packet-Errors-Generic-Name : Check packet errors and discards on an interface
  • Packet-Errors-Global : Check packet errors and discards on interfaces (all interfaces or filtered with regexp)
  • Process-Generic : Check linux processes
  • Systemd-Sc-Status : Check services managed by systemd
  • Traffic-Generic-Name : Check Traffic (single interface)
  • Traffic-Global : Check Traffic (all interfaces or filtered with regexp)

Here are the metrics that are collected by default:

0#core.cpu.utilization.percentageAverage core 0 CPU usage%
1#core.cpu.utilization.percentageAverage core 1 CPU usage%
cpu.utilization.percentageAverage overall CPU usage%


This chapter describes the installation prerequisites required by the plugin to run.

Network flows​

The default TCP port for NRPE is 5666.

PollerMonitored hostTCP5666

Installation of Centreon-packaged NRPE3 daemon and Linux local plugin​

The monitored hosts will need two components to be monitored:

  • the plugin
  • the NRPE3 daemon

To install them, run the commands below:

dnf install -y
dnf install centreon-nrpe3-daemon.x86_64 centreon-plugin-Operatingsystems-Linux-Local.noarch

NB: To avoid installing the Centreon Yum repo on all your monitored Linux servers, both and (current version at the time this document is written) can be installed directly but this installation mode won't allow the packages to be updated with yum update command, so it is not recommended.

NRPE daemon configuration​

The value of the allowed_hosts parameter in /etc/nrpe/centreon-nrpe3.cfg must be changed to include the pollers IP addresses:

# This is an optional comma-delimited list of IP address or hostnames
# that are allowed to talk to the NRPE daemon. Network addresses with a bit mask
# (i.e. are also supported. Hostname wildcards are not currently
# supported.

And the service must be restarted:

systemctl restart centreon-nrpe3.service



The Plugin-Pack installation concerns only the central server and the procedure depends on the type of license.

Install the "Linux NRPE3" Plugin Pack from "Configuration > Plugin Packs > Manager" in the WUI.

Centreon NRPE3 Plugin​

Install this plugin on each poller:

yum install centreon-nrpe3-plugin

Prerequisites and installation validation​

If everything is fine, this command:

/usr/lib64/nagios/plugins/check_centreon_nrpe3 -H monitored_host_ip -p 5666

should produce this output:

NRPE v4.0.3

Otherwise please refer to the troubleshooting section.

Centreon Configuration​

Create a host using the appropriate template​

Go to Configuration > Hosts and click Add. Then, fill the form as shown by the following table:

Once the template has been applied, the following macros can be customized:

XNRPECLIENTName of the plugin to use to dialog with the NRPE3 daemon (default: check_centreon_nrpe3)
XNRPEPORTTCP port the NRPE3 daemon is listening to (default: 5666)
XNRPETIMEOUTCommand timeout (default: 5s)
NRPEEXTRAOPTIONSAny extra option (default: -u to return an UNKNOWN state in case of a connection issue)


How does it work?​

Here is a command monitors the Cpu usage of the Linux Server having the IP address x.x.x.x:

/usr/lib64/nagios/plugins/check_centreon_nrpe3 \
-H x.x.x.x \
-p 5666 -t 5 -u \
-c check_centreon_plugins \
-a 'os::linux::local::plugin' 'cpu' ' --statefile-dir=/var/log/nrpe/centplugins'

It should return this:

OK: CPU(s) average usage is: 1.16% | 'cpu0'=1.64%;;;0;100 'cpu1'=0.98%;;;0;100 'cpu2'=1.09%;;;0;100 'cpu3'=0.94%;;;0;100 'total_cpu_avg'=1.16%;;;0;100

What happened:

  • The check_centreon_nrpe3 executable asked the daemon to run the "check_centreon_plugins" command with "os::linux::local::plugin" "cpu" and " --statefile-dir=/var/log/nrpe/centplugins" as arguments
  • The NRPE daemon puts together the command (that is defined in the NRPE configuration file) with its arguments, forming this local command line:
/usr/lib/centreon/plugins/ --plugin=os::linux::local::plugin --mode=cpu --statefile-dir=/var/log/nrpe/centplugins
  • The NRPE daemon runs this command and sends its results (return code and standard output) back to the check_centreon_nrpe3 executable, that was waiting for the answer.


Let's detail the most common errors.

connect to address x.x.x.x port 5666: Connection refused​

If the output of the command is:

connect to address x.x.x.x port 5666: Connection refused

It probably means that the IP address from which the request was sent is not allowed to dialog with the NRPE daemon.

The allowed_hosts parameter, in the /etc/nrpe/centreon-nrpe3.cfg configuration file (see above).

Then restart the service.

systemctl restart centreon-nrpe3.service

CHECK_NRPE STATE CRITICAL: Socket timeout after 10 seconds​

If the output of the command is:

CHECK_NRPE STATE CRITICAL: Socket timeout after 10 seconds.

Then the following points must be checked:

  • the centreon-nrpe3 is effectively started
systemctl status centreon-nrpe3.service
  • the TCP port that is used by the plugin (-p 5666 for example) is the same as the one configured for the daemon
  • there is no local firewall blocking the NRPE port (iptables -L)
  • there is no firewall device filtering this port on the network

NRPE: Command 'my_command' not defined​

If the output of the command is:

NRPE: Command 'my_command' not defined

This means that the daemon is asked to run a command it doesn't know about.

For a command to be recognized, it has to be defined using the right syntax:

[my_command]=/full/path/to/command --argument --other-argument

And restart the daemon:

systemctl restart centreon-nrpe3.service