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 -> Pollers -> 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 -> Pollers -> Engine configuration 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 -> Pollers -> 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 -> Pollers -> Engine configuration 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).