Forge Home

Modules

Puppet

Resources

PuppetEcosystemPuppet CommunityUpdates

centreon

Management of Centreon provisioning
Project URLRSS FeedReport issues

10,385 downloads

9,741 latest version

4.6 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Support the Puppet Community by contributing to this module

You are welcome to contribute to this module by suggesting new features, currency updates, or fixes. Every contribution is valuable to help ensure that the module remains compatible with the latest Puppet versions and continues to meet community needs. Complete the following steps:

  1. Review the module’s contribution guidelines and any licenses. Ensure that your planned contribution aligns with the author’s standards and any legal requirements.
  2. Fork the repository on GitHub, make changes on a branch of your fork, and submit a pull request. The pull request must clearly document your proposed change.

For questions about updating the module, contact the module’s author.

Version information

  • 0.1.2 (latest)
  • 0.1.1
  • 0.1.0
released Jan 8th 2015
This version is compatible with:
  • , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'knak-centreon', '0.1.2'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add knak-centreon
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install knak-centreon --version 0.1.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.

Download
Tags: monitoring, provisioning, centreon, clapi

Documentation

knak/centreon — version 0.1.2 Jan 8th 2015

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