centreon

Management of Centreon provisioning
Maxime VISONNEAU

Maxime VISONNEAU

knak

8,945 downloads

8,472 latest version

4.6 quality score

Version information

  • 0.1.2 (latest)
  • 0.1.1
  • 0.1.0
released Jul 3rd 2019
This version is compatible with:
  • RedHat
    ,
    CentOS
    ,
    Debian
    ,
    Ubuntu

Start using this module

Documentation

knak/centreon — version 0.1.2 Jul 3rd 2019

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 Binaries
    clapi_username      => # MANDATORY - CLAPI Username
    clapi_password      => # MANDATORY - CLAPI Password
    clapi_export_file   => # MANDATORY - CLAPI Exportfile
    poller_name         => # MANDATORY - Name of Centreon Poller
    alias               => # MANDATORY - Alias of the host
    address             => # MANDATORY - IP Address
    template            => # MANDATORY - Host template to use, must be defined in Centreon to avoid config errors
    ensure              => # MANDATORY - Whether the host is present or not into the configfile
    enabled             => # OPTIONAL  - Set the status of the host (true or false - default:true)
  }

Centreon Service : centreon_service :

centreon_service { 'resource title':
    clapi_binaries      => # MANDATORY - CLAPI Binaries
    clapi_username      => # MANDATORY - CLAPI Username
    clapi_password      => # MANDATORY - CLAPI Password
    clapi_export_file   => # MANDATORY - CLAPI Exportfile
    hostname            => # MANDATORY - Hostname of the host to map the service on
    description         => # MANDATORY - Description of the service ( servicename in Centreon )
    template            => # MANDATORY - Service template to use, must be defined in Centreon to avoid config errors
    ensure              => # MANDATORY - Whether the service is present or not into the configfile
    enabled             => # 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 path
      clapi_username     =>  # MANDATORY - CLAPI Username
      clapi_password     =>  # MANDATORY - CLAPI Password
      clapi_export_file  =>  # MANDATORY - Path to export config from CLAPI as cache
      clapi_log_file     =>  # MANDATORY - CLAPI Log file
      poller_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