Use Shinken with Centreon

Centreon

Centreon is a famous French monitoring solution based on Nagios, which can also be used with Shinken.

How to use Shinken as a Centreon backend

The following Shinken Broker modules are required:
  • NDO/MySQL
  • Simple log
  • Flat file perfdata

Below is the configuration you should set (there is already a sample configuration in your ‘’/etc/shinken/shinken-specific.cfg’’ file)

Simple log

The module simple_log puts all Shinken’s logs (Arbiter, Scheduler, Poller, etc.) into a single file.

In ‘’/etc/shinken/shinken-specific.cfg’‘:

define module{

module_name      Simple-log
module_type      simple_log
path             /var/lib/nagios/nagios.log
archive_path     /var/lib/nagios/archives/

}

It takes these parameters:
  • module_name: name of the module called by the brokers
  • module_type: simple_log
  • path: path of the log file

NDO/MySQL

The module ndodb_mysql exports all data into a NDO MySQL database.

It needs the python module MySQLdb (Debian: ‘’sudo apt-get install python-mysqldb’‘, or ‘’easy_install MySQL-python’‘)

In ‘’/etc/shinken/shinken-specific.cfg’‘:

define module{

module_name      ToNdodb_Mysql
module_type      ndodb_mysql
database         ndo       ; database name
user             root      ; user of the database
password         root      ; must be changed
host             localhost ; host to connect to
character_set    utf8      ;optional, default: utf8

}

It takes the following parameters:
  • module_name: name of the module called by the brokers
  • module_type: ndodb_mysql
  • database: database name (ex ndo)
  • user: database user
  • password: database user passworddt
  • host: database host
  • character_set: utf8 is a good one

Service Perfdata

The module service_perfdata exports service’s perfdata to a flat file.

In ‘’/etc/shinken/shinken-specific.cfg’‘:

define module{

module_name      Service-Perfdata
module_type      service_perfdata
path             /var/lib/shinken/service-perfdata

}

It takes the following parameters:
  • module_name: name of the module called by the brokers
  • module_type: service_perfdata
  • path: path to the service perfdata file you want

Configure Broker to use these modules

In ‘’/etc/shinken/shinken-specific.cfg’’ find the object Broker, and add the above modules to the modules line:

define broker{

     broker_name      broker-1
[...]

modules          Simple-log,ToNdodb_Mysql,Service-Perfdata

}

Configure Scheduler to match Centreon’s Poller

Shinken’s “Scheduler” is called a “Poller” in Centreon. If you keep the sample Scheduler name, you won’t see any data in the Centreon interface.

So edit ‘’/etc/shinken/shinken-specific.cfg’’ and change the Scheduler name to match the Centreon’s Poller name (“default”):

define scheduler{

scheduler_name   default
[...]

}