Forge Home


Report puppet runs to Nagios/Icinga using NSCA


9,714 latest version

3.9 quality score

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