Forge Home

nrpe

Puppet module for NRPE

30,015 downloads

877 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 6.0.0 (latest)
  • 5.0.0
  • 4.0.0
  • 3.0.0
released Mar 10th 2023
This version is compatible with:
  • Puppet Enterprise 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x
  • Puppet >= 6.1.0 < 8.0.0
  • , , , , , , , , Solaris

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'puppet-nrpe', '6.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add puppet-nrpe
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install puppet-nrpe --version 6.0.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

puppet/nrpe — version 6.0.0 Mar 10th 2023

NRPE Module for Puppet

License Build Status Puppet Forge Puppet Forge - downloads Puppet Forge - scores

Table of Contents

  1. Module Description - What the module does and why it is useful
  2. Setup - The basics of getting started with this module
  3. Usage - Configuration options and additional functionality
  4. Reference - Puppet Strings based reference documentation
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module

Module Description

NRPE (Nagios Remote Plugin Executor) allows you to remotely execute Nagios plugins on other Linux/Unix machines. This allows you to monitor remote machine metrics (disk usage, CPU load, etc.). This puppet module manages the installation and configuration of NRPE. It can install NRPE plugins and setup NRPE commands. Secure communication to NRPE using SSL is also supported.

Setup

The nrpe class installs the packages and configures the daemon. By default, it will only configure the daemon to listen on localhost. To allow connections from your nagios server, specify the allowed_hosts parameter when declaring the class.

class { 'nrpe':
  allowed_hosts => ['127.0.0.1', 'nagios.example.org'],
}

Usage

nrpe

No NRPE commands are configured by default. To make the configuration useful, at a minimum, declare some nrpe::command resources. To purge unmanaged NRPE commands:

class { 'nrpe':
  allowed_hosts => ['127.0.0.1'],
  purge         => true,
  recurse       => true,
}

Full documentation for the nrpe class is available in the reference documentation.

nrpe::command

This define can be used to add NRPE commands to the include directory for NRPE.

nrpe::command { 'check_users':
  ensure  => present,
  command => 'check_users -w 5 -c 10',
}

It is also possible to use hiera data to create these resources by using the base class commands parameter.

nrpe::commands:
  check_users:
    ensure: present
    command: 'check_users -w 5 -c 10'

Full documentation for the nrpe::command type is available in the reference documentation.

nrpe::plugin

This define can be used to install NRPE plugins.

nrpe::plugin { 'check_mem':
  ensure => present,
  source => 'puppet:///files/check_mem',
}

It is also possible to use hiera data to create these resources by using the base class plugins parameter.

nrpe::plugins:
  check_users:
    ensure: present
    source: 'puppet:///files/check_mem'

Full documentation for the nrpe::plugin type is available in the reference documentation.

Reference

See REFERENCE.md. This module has been documented with puppet-strings.

Limitations

Redhat

  • This module requires the EPEL repositories to be enabled
  • This module currently does not manage the firewall rules

Solaris

  • This module depends on OpenCSW packages

Development

Improvements and bug fixes are greatly appreciated.

To regenerate the REFERENCE.MD file, please run the rake task as follows.

 % bundle exec rake strings:generate\[',,,,false,true']

This module is a fork of pdxcat/nrpe

It is licensed under the Apache License, Version 2.0.