Use Shinken with Centreon

Centreon

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

../_images/centreon.png

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 sample configuration files in your ‘’/etc/shinken/’’ directory)

Simple log

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

In ‘’/etc/shinken/modules/simple-log.cfg’‘:

define module{
     module_name      Simple-log
     module_type      simple_log
     path             /var/lib/shinken/shinken.log
     archive_path     /var/lib/shinken/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/modules/ndodb_mysql.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/modules/perfdata-service.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/brokers/broker-master.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/schedulers/scheduler-master.cfg’’ and change the Scheduler name to match the Centreon’s Poller name (“default”):

define scheduler{
    scheduler_name   default
    [...]
}
Read the Docs v: latest
Versions
latest
stable
branch-1.4
2.4.1
2.2
2.0.3
1.4.2
Downloads
pdf
htmlzip
epub
On Read the Docs
Project Home
Builds

Free document hosting provided by Read the Docs.