nrpe

NRPE installation & management

Phillip Hagedorn

phagedorn

9,536 downloads

8,790 latest version

4.1 quality score

Version information

  • 1.4.4 (latest)
  • 1.4.3
  • 1.4.2
  • 1.4.1
  • 1.4.0
  • 1.3.1
released Nov 4th 2014

Start using this module

Documentation

phagedorn/nrpe — version 1.4.4 Nov 4th 2014

puppet-nagios-nrpe

This module automates the installation/management of the NRPE agent for Nagios/Opsview.

Tested to work on 32-bit/64-bit:

  • Amazon AWS Linux
  • CentOS 6.x
  • Ubuntu 12.04

Parameters

  • allowed_hosts: required, an array of allowed IPs that can connect to this NRPE instance
  • ensure: optional, running or stopped, default=running
  • enable: optional, boolean, default=true
  • dont_blame_nrpe: optional, boolean, default=false (dont_blame_nrpe=0), toggle the dont_blame_nrpe config to enable/disable argument passing to check commands
  • opsview_use: optional, boolean, default=false, define basic check commands with arguments enabled, you have to set dont_blame_nrpe=true to make this work
  • service_check_command: optional, default={}, a hash containing the additional command definitions e.g. { 'command_name' => '/path/to/it ARG' }

Usage

Basic:

class { 'nrpe':
  allowed_hosts => [ "192.168.56.9", "10.10.10.23", ],
}

Modify the behaviour of the NRPE service:

class { 'nrpe':
  allowed_hosts => [ "192.168.56.9", "10.10.10.23", ],
  ensure => running,
  enable => false,
}

If you want to add custom service check commands:

class { 'nrpe':
  allowed_hosts         => [ "192.168.56.9", "10.10.10.23", ],
  ensure                => running,
  enable                => false,
  service_check_command => {
    'check_mem'  => '/usr/local/nagios/plugins/check_mem 40 60',
    'check_blah' => '/usr/local/nagios/plugins/check_blah arg1 arg2',
  },
}

Example above will create the following in /etc/nagios/nrpe.cfg:

command[check_mem]=/usr/local/nagios/plugins/check_mem 40 60
command[check_blah]=/usr/local/nagios/plugins/check_blah arg1 arg2

If you use Opsview, you might want to enable argument passing and some default check commands:

class { 'nrpe':
  allowed_hosts         => [ "192.168.56.9", "10.10.10.23", ],
  ensure                => running,
  enable                => true,
  dont_blame_nrpe       => true,
  opsview_use           => true,
  service_check_command => {
    'check_mem'  => '/usr/local/nagios/plugins/check_mem 40 60',
  }
}

opsview_use => true

This will enable the following check commands in /etc/nagios/nrpe.cfg:

command[check_users]=<%= libpath %>/nagios/plugins/check_users $ARG1$
command[check_disk]=<%= libpath %>/nagios/plugins/check_disk $ARG1$
command[check_procs]=<%= libpath %>/nagios/plugins/check_procs $ARG1$
command[check_load]=<%= libpath %>/nagios/plugins/check_load $ARG1$
command[check_swap]=<%= libpath %>/nagios/plugins/check_swap $ARG1$

Note: You have to set dont_blame_nrpe => true for this to work properly.

include_nrpe_d => true

This will include all files in nrpe.d/ as nrpe config.

Dependencies

For RHEL based distributions.