Architectures

Single Poller

If your monitoring needs are small and a single poller will be enough for the job, you only have to configure a single Centreon Broker instance, namely the module loaded within your monitoring engine.

../_images/broker_single_poller.png

Centreon Broker Configuration

In this setup, Centreon Broker only needs to be configured on the single central poller.

In Centreon Web, go to Configuration -> Centreon -> Centreon Broker -> Configuration. Click the add button and enter the following informations:

Name Central-Module
Config file name central-module.xml
Status Enabled
Requester Central

Add a logger object to your convenience and add an output object with the following characteristics:

Type SQL - Broker SQL Database
Name Database-Master
DB Type MySQL
Failover name  
DB host <your DB host>
DB port 3306
DB user <your DB user>
DB password <your DB password>
DB name centreon_storage

Engine Configuration

In Centreon Web, go to Configuration -> Nagios -> main.cfg and enter the main configuration file. In the Data tab, change the Multiple Broker Module line to /path/to/your/cbmod.so /path/to/your/central-module.xml.

The path to Centreon Broker’s module (cbmod.so) was defined when you install centreon broker. The path to the configuration file is defined in Configuration -> Centreon -> Central -> Centreon Broker configuration path.

Note

you do not need the “config_file=” part on the broker module line anymore.

Application

Save the file and export configuration files and restart your poller through Centreon Web interface (Configuration -> Nagios menu).

Multiple pollers

If you plan on monitoring more than thousands of services, you’ll probably need multiple pollers. In such cases, the architecture is different from the single poller architecture. In these cases, instead of sending data directly in the database, we will bounce on a Centreon Broker daemon that will insert data in the DB itself. We will use the port 5668 for this purpose.

../_images/broker_multiple_pollers.png

Centreon Broker Configuration

On Pollers

In Centreon Web, go to Configuration Centreon -> Centreon Broker -> Configuration. For each poller, click the add button and enter the following information:

Name <your poller name>-Module
Config file name <your poller name>-module.xml
Status Enabled
Requester <your target poller>

Add a logger object to your convenience and add an output object with the following characteristics (leave default when unspecified):

Type TCP - IPv4
Name Broker-Master
Host to connect to <address of the central Broker machine>
Connection port 5668
Serialization protocol BBDO Protocol

On Central

In Centreon Web, go to Configuration Centreon -> Centreon Broker -> Configuration. Click the add button and enter the following information:

Name Central-Broker
Config file name central-broker.xml
Status Enabled
Requeste Central

Note

if using startup scripts (SysV or Upstart), you should check that the config file name you entered above match the script. Otherwise, strange behavior might occur.

Add a logger object to your convenience.

Add an input object with the following characteristics (leave default when unspecified):

Type TCP - IPv4
Name Broker-Master
Host to connect to  
Connection port 5668
Serialization protocol BBDO Protocol

Add an output object with the following characteristics:

Type SQL - Broker SQL Database
Name Database-Master
DB Type MySQL
Failover name  
DB host <your DB host>
DB port 3306
DB user <your DB user>
DB password <your DB password>
DB name centreon_storage

Engine Configuration

In Centreon Web, go to Configuration -> Nagios -> nagios.cfg and enter the main configuration file. In the Data tab, change the Multiple Broker Module line to /path/to/your/cbmod.so /path/to/your/central-module.xml.

The path to Centreon Broker’s module (cbmod.so) was defined when you installed Centreon Broker. The path to the configuration file is defined in Configuration -> Centreon -> Central -> Centreon Broker configuration path.

Application

Save the file, export configuration files and restart your poller through Centreon Web interface (Configuration -> Monitoring Engine menu).