Automate Nagios Monitoring with Puppet

Table of Content

1 Introduction
2 Use case
- 2.1 Prerequisites
3 Solution
- 3.1 Install & Configure Puppet
- 3.2 Configure Nagios using Puppet
4 Conclusion
5 References

Introduction

Nagios

Nagios is an Open Source monitoring tool that provides a comprehensive monitoring environment. It monitors the entire IT infrastructure such as servers, switches, applications, network and services sending alert messages about issues and system recovery.

Technical benefits of Nagios

Monitors our entire IT infrastructure
Enables problem forecasting
Generates immediate alerts on issues
Facilitates Information sharing with stakeholders
Minimizes downtime and business loss

System Monitoring Tool Voting Results

The screenshot below illustrates the output of the system monitoring tool – “voting results”

Use case

This use case details the procedures to setup Nagios monitoring and Nagios plug-in installations with Puppet services.

Prerequisites

Install & Configure Puppet
Configure Nagios using Puppet

Solution

Install & Configure Puppet

Numerous blog resources provide information on Puppet installation and configuration procedures.

Click the links below to learn more:

http://terokarvinen.com/2012/puppetmaster-on-ubuntu-12-04

https://www.digitalocean.com/community/tutorials/how-to-install-puppet-to-manage-your-server-infrastructure

Configure Nagios using Puppet

#puppet resource package puppetdb ensure=latest

Create /etc/puppet/puppetdb.conf

# vi /etc/puppet/puppetdb.conf
[main]
server = ubuntu.server.com 
port = 8081
soft_write_failure = false

Add to /etc/puppet/puppet.conf

# vi /etc/puppet/puppet.conf
[main]
storeconfigs = true
storeconfigs_backend = puppetdb

Create /etc/puppet/routes.yaml

# vi /etc/puppet/routes.yaml
master:
facts:
terminus: puppetdb
cache: yaml

#puppet resource package puppetdb ensure=latest

Create /etc/puppet/puppetdb.conf

# vi /etc/puppet/puppetdb.conf

[main]

server = ubuntu.server.com

port = 8081

soft_write_failure = false

Add to /etc/puppet/puppet.conf

# vi /etc/puppet/puppet.conf

[main]

storeconfigs = true

storeconfigs_backend = puppetdb

Create /etc/puppet/routes.yaml

# vi /etc/puppet/routes.yaml

master:

facts:

terminus: puppetdb

cache: yaml

#service puppetdb start 
#service puppetmaster restart

1 2	#service puppetdb start #service puppetmaster restart

# vi nagios/manifests/init.pp

class nagios {
    include nagios::install
    include nagios::service
    include nagios::import
}

# vi nagios/manifests/install.pp

class nagios::install {
    		package { [ 'nagios', 'nagios-plugins', 'nagios-nrpe-plugin' ]:
        		ensure  => present,
    }
}

# vi nagios/manifests/service.pp

class nagios::service {

    exec { 'fix-permissions':
        command    => "find /etc/nagios/conf.d -type f -name '*cfg' | xargs chmod +r",
        refreshonly  => true,
    } 

    service { 'nagios':
        ensure      	=> running,
        enable      	=> true,
        require    	 => Class[ 'nagios::install' ],
    }
}

# vi nagios/manifests/import.pp

class nagios::import {

    Nagios_host <<||>> {
        require 	=> Class[ 'nagios::install' ],
        notify  	=> Class[ 'nagios::service' ]
    }

    Nagios_service <<||>> {
        require 	=> Class[ 'nagios::install' ],
        notify  	=> Class[ 'nagios::service' ]
    }
}

#vi nagios/manifests/nrpe.pp

class nagios::nrpe {

    package { [ 'nagios-nrpe-server', 'nagios-plugins' ]:
        ensure      => present,
    }

    service { 'nagios-nrpe-server':
        ensure      => running,
        enable      => true,
        require     => Package[ 'nagios-nrpe-server', 'nagios-plugins' ] ],
    }
}

# vi nagios/manifests/export.pp

class nagios::export {

    @@nagios_host { $::hostname :
        ensure              	=> present,
        address            	 => $::ipaddress,
        use                	 => 'generic-host',
        check_command      => 'check-host-alive',
        hostgroups          	=> 'all-servers',
        target             	 => "/etc/nagios/conf.d/${::hostname}.cfg",
    }

    @@nagios_service { "${::hostname}_check-load":
        ensure              	=> present,
        use                 	=> 'generic-service',
        host_name           	=> $::hostname,
        service_description => 'Current Load',
        check_command      => 'check_nrpe!check_load',
        target              	=> "/etc/nagios/conf.d/${::hostname}.cfg",
    }

    @@nagios_service { "${::hostname}_check-disk":
        ensure              	=> present,
        use                 	=> 'generic-service',
        host_name           	=> $::hostname,
        service_description => 'Disk Usage,
        check_command      => 'check_nrpe!check_hda1',
        target              	=> "/etc/nagios/conf.d/${::hostname}.cfg",
    }
}

# vi manifests/nodes.pp

node default {
    include nagios::nrpe
    include nagios::export
}

100

# vi nagios/manifests/init.pp

class nagios {

include nagios::install

include nagios::service

include nagios::import

}

# vi nagios/manifests/install.pp

class nagios::install {

package { [ 'nagios', 'nagios-plugins', 'nagios-nrpe-plugin' ]:

ensure => present,

}

# vi nagios/manifests/service.pp

class nagios::service {

exec { 'fix-permissions':

command => "find /etc/nagios/conf.d -type f -name '*cfg' | xargs chmod +r",

refreshonly => true,

}

service { 'nagios':

ensure => running,

enable => true,

require => Class[ 'nagios::install' ],

}

# vi nagios/manifests/import.pp

class nagios::import {

Nagios_host <<||>> {

require => Class[ 'nagios::install' ],

notify => Class[ 'nagios::service' ]

}

Nagios_service <<||>> {

require => Class[ 'nagios::install' ],

notify => Class[ 'nagios::service' ]

}

#vi nagios/manifests/nrpe.pp

class nagios::nrpe {

package { [ 'nagios-nrpe-server', 'nagios-plugins' ]:

ensure => present,

}

service { 'nagios-nrpe-server':

ensure => running,

enable => true,

require => Package[ 'nagios-nrpe-server', 'nagios-plugins' ] ],

}

# vi nagios/manifests/export.pp

class nagios::export {

@@nagios_host { $::hostname :

ensure => present,

address => $::ipaddress,

use => 'generic-host',

check_command => 'check-host-alive',

hostgroups => 'all-servers',

target => "/etc/nagios/conf.d/${::hostname}.cfg",

}

@@nagios_service { "${::hostname}_check-load":

ensure => present,

use => 'generic-service',

host_name => $::hostname,

service_description => 'Current Load',

check_command => 'check_nrpe!check_load',

target => "/etc/nagios/conf.d/${::hostname}.cfg",

}

@@nagios_service { "${::hostname}_check-disk":

ensure => present,

use => 'generic-service',

host_name => $::hostname,

service_description => 'Disk Usage,

check_command => 'check_nrpe!check_hda1',

target => "/etc/nagios/conf.d/${::hostname}.cfg",

}

# vi manifests/nodes.pp

node default {

include nagios::nrpe

include nagios::export

}

Restart the puppetmaster and puppetdb service

Finally, apply the puppet

# puppet apply nodes.pp

1	# puppet apply nodes.pp

Check http://localhost/nagios – It works…

Conclusion

Nagios provides an insight into our network performance and availability. It enables a fast response to errors in our network, and most importantly quickly notifies errors even before others sense the issues. It’s a very good example to understand how the Open Source community can assist you in network management.

References

Refer https://exchange.nagios.org/directory/Tutorials/Nagios-Core-Tutorials for any further information.

16170 Views 1 Views Today

Blog