Forge Home


Report puppet runs to Nagios/Icinga using NSCA


10,205 latest version

3.9 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

  • 0.0.2 (latest)
  • 0.0.1
released Oct 9th 2013

Start using this module

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

Add this module to your Puppetfile:

mod 'alexh-nsca_report', '0.0.2'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add alexh-nsca_report
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install alexh-nsca_report --version 0.0.2

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.



alexh/nsca_report — version 0.0.2 Oct 9th 2013


####Table of Contents

  1. Overview
  2. Setup


The nsca_report module ships a custom puppet report processor to process and send the results of puppet agent runs to a Nagios/Icinga monitoring server.



On the Nagios/Icinga side configure a passive service check for each puppet client:

define service{
        use                             linux-service
        hostgroup_name                  linux
        service_description             NRPE_puppet_status
        check_command                   check_nrpe!\!/var/lib/puppet/state/state.yaml\!3h\!4h
        max_check_attempts              1
        freshness_threshold             6000
        active_checks_enabled           0
        check_freshness                 1


In order to process and send the Puppet agents results, enable report processing in /etc/puppet/puppet.conf.

On each puppet client put

  report = true 

in /etc/puppet/puppet.conf

On the server-side put

  reports = nsca
  pluginsync = true

in /etc/puppet/puppet.conf

The NSCA report expects a configuration file with connection information in /etc/puppet/nsca.yaml. Example:

:nsca_binary: /usr/bin/send_nsca
:nsca_host: <HOSTNAME>
:nsca_config: /etc/nagios/send_nsca.cfg
:nsca_port: 5667
:service_desc: NRPE_puppet_status
:strip_domain: true
:only_env: production