Nagios/Icinga/Nrpe Modul for Puppet

This module provides distributed configuration from Nagios/Icinga.

Features

• Nagios engine / Icinga engine configurable
• Web access user configurable
• Install core engine on monitor host and nrpe service on clients
• Configre allowed hosts on nrpe and usage of expand conf or overwrite existing conf
• Standard service checks with NRPE provided by nagios-plugins
• Some plugin check extensions called 'local' checks
• Multiple plugin check extensions included as sub module (e.g. mongodb check)
• Distributed monitoring with NSCA
• Service freshness in passive checks and translating host checks activated
• SMS + Voice notification with Twilio service
• RRD stats support with pnp4nagios

Non-Features

Exported resources are deleted in this version due the different requirements Service discovering are deleted due the excessive false possitives

Usage

Install server and setup http authentication user:

class {'nagios::server':
  engine     => 'icinga',
  httpd_user => 'www-run',
  http_users => {
    admin => { 'password' => '$apr1$x6DQznUt$hh05hGiXnBzfi4m0iKlty1' },
    peter => { 'password' => '$apr1$Pm4kjpYB$8KGIuRB49Skdf/5/nWfUN1' },
  }
}

Using Twilio for SMS and Voice notification:

class {'nagios::server':
  engine             => 'nagios',
  twilio_account     => 'ABCDEFGHIJKLMNOPQRSTUVWXYZ',  # your twilio account number
  twilio_identifier  => 'abcdefghijklmnopqrstuvqxyz',  # your twilio secret identifier
  twilio_from        => '%2B1123456790',               # your urlenode twilio number, e.g. +1 123 456 7890
  twilio_to          => '%2B491721234567',             # your urlencode oncall number, e.g +49 172 123 4567
  notification       => ['root@localhost','nagios@localhost'], # single or multiple email addresses
}

You can register for Twilio services on https://www.twilio.com

This version doesn't use exported resources in puppet. So all hosts must configured in a hash:

nd => {
  'ab.beispiel.de' => {
    'ip'       => '192.168.0.100',
    'domain'   => 'beispiel.de',
    'services' => {
      'Ping' => { check => 'check_ping!200.0,60%!500.0,95%', notes => 'group_sms' }, 
      'Load' => { check => 'check_nrpe!check_load!15 10 5 30 25 20', notes => 'group_email,group_sms,group_voice'},
    },
  },
  'ns.beispiel.de' => {
    'ip'       => '192.168.0.10',
    'domain'   => 'beispiel.de',
    'notes'    => 'group_voice',
    'services' => {
      'Ping' => { check => 'check_ping!200.0,60%!500.0,95%'},
    },
  },
  'gw.beispiel.de' => {
    'ip'       => '192.168.0.1',
    'domain'   => 'beispiel.de',
    'services' => {
      'Ping' => { check => 'check_ping!400.0,80%!500.0,95%'},
    },
  },
}

'notes' are optional for services for additional notification SMS + Voice (delivered by Twilio). Default notification for all services is email

Install NRPE and configure allowed hosts:

class {'nagios::nrpe':
      nrpe_allowed_hosts  => '192.168.0.10',
      timeserver          => '192.168.0.15',
      nrpe_conf_overwrite => 1,
}

Use distribted monitor system with NSCA:

distribution       => {
  member             => 'client',        # possible values: client, master
  host               => '192.168.0.110', # master host ip address
  nsca_password      => '12345678',      # password for communication
},

Let perfom permance graphs via pnp4nagios

class {'nagios::server':
  pnp4nagios         => 1,
  pnp4nagios_rrdbase => '/data/pnp4nagios/',  # needs the slash at the end
}

Note: Package pnp4nagios is not in offical OpenSUSE packages. You need to setup additional repo like http://download.opensuse.org/repositories/server:/monitoring/openSUSE_12.3/

Describe the service in an external Wiki or link to an existing operation manual

class {'nagios::server':
  notesurl           => 'http://wiki.example.de/index.php/?host=$HOSTNAME$&srv=$SERVICEDESC$'
}

Install Icinga Command Line Interface (icli):

class {'nagios::server':
  icli         => 1,
}

Usage: # icli # icli -z !o # icli -z !oA # icli -s Load # icli -h host.beispiel.de # icli -g hostgruppe.beispiel.de

Testing

Developed for Ubuntu and OpenSUSE, will be expand.

required packages can be found in:

zypper addrepo http://download.opensuse.org/repositories/server:monitoring/openSUSE_13.2/server:monitoring.repo
zypper refresh

Hints for Ubuntu 16.04:

• nagios-nrpe-server haven't support for command arguments anmore (https://bugs.launchpad.net/ubuntu/+source/nagios-nrpe/+bug/1555258) workaround would recompile package with this option or use a ppa:

  add-apt-repository -y ppa:richardmoe/ppa

• icinga has another bug in the html source tree (https://bugs.launchpad.net/ubuntu/+source/icinga/+bug/1593319) workaround is another ppa:

  add-apt-repository -y ppa:nacc/lp1593319

Contributing

1. Fork it.
2. Create a branch (git checkout -b my_markup)
3. Commit your changes (git commit -am "Added Snarkdown")
4. Push to the branch (git push origin my_markup)
5. Open a [Pull Request][1]
6. Enjoy a refreshing Diet Coke and wait