puppet-centreon

Overview

This module provides the provisioning of nodes onto one or several Centreon monitoring server through CLAPI. It works whatever the engine/broker you use : Nagios, Shinken and Centreon Engine / NDO2DB and Centreon Broker

Limitations

• It does not provide the installation of the Centreon server (yet).
• You can use only one poller for the moment
• Configuration of hosts and services only

Requirements

• At least one Centreon server up and running ( >= 2.0 ) with the CLAPI module configured ( >= 1.6 )
• Stored configurations enabled on the puppetmaster (mandatory)

Sample Usage

Centreon server instance :

class { 'centreon::server':
clapi_binaries => '/app/centreon/www/modules/centreon-clapi/core',
clapi_username => 'admin',
clapi_password => 'password',
clapi_export_file => '/tmp/clapi.conf',
clapi_log_file => '/var/log/centpollers.log',
poller_name => 'central',
}

Centreon client instances :

class { 'centreon::client': }

Types definitions

Centreon HOST : centreon_host :

centreon_host { 'resource title':
clapi_binaries => # MANDATORY - CLAPI Binariesclapi_username => # MANDATORY - CLAPI Usernameclapi_password => # MANDATORY - CLAPI Passwordclapi_export_file => # MANDATORY - CLAPI Exportfilepoller_name => # MANDATORY - Name of Centreon Polleralias => # MANDATORY - Alias of the hostaddress => # MANDATORY - IP Addresstemplate => # MANDATORY - Host template to use, must be defined in Centreon to avoid config errorsensure => # MANDATORY - Whether the host is present or not into the configfileenabled => # OPTIONAL - Set the status of the host (true or false - default:true)
}

Centreon Service : centreon_service :

centreon_service { 'resource title':
clapi_binaries => # MANDATORY - CLAPI Binariesclapi_username => # MANDATORY - CLAPI Usernameclapi_password => # MANDATORY - CLAPI Passwordclapi_export_file => # MANDATORY - CLAPI Exportfilehostname => # MANDATORY - Hostname of the host to map the service ondescription => # MANDATORY - Description of the service ( servicename in Centreon )template => # MANDATORY - Service template to use, must be defined in Centreon to avoid config errorsensure => # MANDATORY - Whether the service is present or not into the configfileenabled => # OPTIONAL - Set the status of the service (true or false - default:true)check_command => # OPTIONAL - Check command to override the template
}

Classes definitions

centreon::server :

class { 'centreon::server':
clapi_binaries => # MANDATORY - CLAPI Binaries pathclapi_username => # MANDATORY - CLAPI Usernameclapi_password => # MANDATORY - CLAPI Passwordclapi_export_file => # MANDATORY - Path to export config from CLAPI as cacheclapi_log_file => # MANDATORY - CLAPI Log filepoller_name => # MANDATORY - Name of Centreon poller to provision the hosts
}

centreon::client :

class { 'centreon::client': }

Roadmap

• Add the possibility to split the provisioning onto multiple pollers.
• Implement the centreon_host and centreon_service with all the possibilities that offers Centreon CLAPI.
• Implement the other configuration definitions available with Centreon CLAPI