Centreon broker

Overview

Object name: CENTBROKERCFG

Show

In order to list available Centreon Broker CFG, use the SHOW action:

[root@centreon ~]# ./centreon -u admin -p centreon -o CENTBROKERCFG -a show
config id;config name;instance
1;Central CFG;Central
2;Sattelite CFG;Sattelite
[...]

Columns are the following:

Order	Description
1	ID
2	Name of configuration
3	Instance that is linked to broker cfg

Add

In order to add a Centreon Broker CFG, use the ADD action:

[root@centreon ~]# ./centreon -u admin -p centreon -o CENTBROKERCFG -a add -v "broker cfg for poller test;Poller test"

Required fields are:

Order	Description
1	Name of configuration
2	Instance that is linked to broker cfg

Del

If you want to remove a Centreon Broker CFG, use the DEL action. The Name is used for identifying the configuration to delete:

[root@centreon ~]# ./centreon -u admin -p centreon -o CENTBROKERCFG -a del -v "broker cfg for poller test"

Setparam

If you want to change a specific parameter of a Centreon Broker configuration, use the SETPARAM action. The configuration name is used for identifying the configuration to update:

[root@centreon ~]# ./centreon -u admin -p centreon -o CENTBROKERCFG -a setparam -v "broker cfg for poller test;name;new broker cfg name"

Arguments are composed of the following columns:

Order	Column description
1	Name of Centreon Broker configuration
2	Parameter name
3	Parameter value

Parameters that you may change are:

Column	Description
filename	Filename of configuration (.xml extension)
name	Name of configuration
instance	Instance that is linked to Centreon Broker CFG
event_queue_max_size	Event queue max size (when number is reached, temporary output will be used).
cache_directory	Path for cache files
daemon	Link this configuration to cbd service (0 or 1)
correlation_activate	Enable correlation (0 or 1)

Listinput, Listoutput and Listlogger

If you want to list specific input output types of Centreon Broker, use one of the following commands: listinput listoutput listlogger

Example:

[root@centreon ~]# ./centreon -u admin -p centreon -o CENTBROKERCFG -a listoutput -v "broker cfg for poller test"
id;name
1;Storage
2;RRD
3;PerfData

Columns are the following :

Column	Description
ID	I/O ID
Name	I/O Name

Getinput, Getoutput and Getlogger

In order to get parameters of a specific I/O object, use one of the following commands:

• getinput

• getoutput

• getlogger

Example:

[root@centreon ~]# ./centreon -u admin -p centreon -o CENTBROKERCFG -a getoutput -v "broker cfg for poller test;3"
parameter key;parameter value
db_host;localhost
db_name;centreon_storage
db_password;centreon
db_port;3306
db_type;mysql
db_user;centreon
interval;60
length;
name;PerfData
type;storage

The ID is used for identifying the I/O to get.

Columns are the following :

Order	Description
1	Parameter key of the I/O
2	Parameter value of the I/O

Addinput, Addoutput and Addlogger

In order to add a new I/O object, use one of the following commands:

• ADDINPUT

• ADDOUTPUT

• ADDLOGGER

Example:

[root@centreon ~]# ./centreon -u admin -p centreon -o CENTBROKERCFG -a addlogger -v "broker cfg for poller test;/var/log/centreon-broker/central-module.log;file"
[root@centreon ~]# ./centreon -u admin -p centreon -o CENTBROKERCFG -a listlogger -v "broker cfg for poller test"
id;name
1;/var/log/centreon-broker/central-module.log

Arguments are composed of the following columns:

Order	Column description
1	Name of Centreon Broker CFG
2	Name of the I/O object
3	Nature of I/O object

Delinput, Deloutput and Dellogger

In order to remove an I/O object from the Centreon Broker configuration, use one of the following commands:

• DELINPUT

• DELOUTPUT

• DELLOGGER

Example:

[root@centreon ~]# ./centreon -u admin -p centreon -o CENTBROKERCFG -a dellogger -v "broker cfg for poller test;1"

The I/O ID is used for identifying the object to delete.

Setintput, Setoutput and Setlogger

In order to set parameters of an I/O object, use one of the following commands:

• SETINPUT

• SETOUTPUT

• SETLOGGER

Example:

[root@centreon ~]# ./centreon -u admin -p centreon -o CENTBROKERCFG -a setlogger -v "broker cfg for poller test;1;debug;no"

Arguments are composed of the following columns:

Order	Column description
1	Name of Centreon Broker CFG
2	ID of I/O object
3	Parameter name
4	Parameter value, for multiple values, use the “,” delimiter

You may get help with the following CLAPI commands:

• GETTYPELIST

• GETFIELDLIST

• GETVALUELIST

Example:

[root@localhost core]# ./centreon -u admin -p centreon -o CENTBROKERCFG -a gettypelist -v "output"
type id;short name;name
27;bam_bi;BI engine (BAM)
16;sql;Broker SQL Database
32;correlation;Correlation
28;db_cfg_reader;Database configuration reader
29;db_cfg_writer;Database configuration writer
11;file;File
3;ipv4;IPv4
10;ipv6;IPv6
26;bam;Monitoring engine (BAM)
14;storage;Perfdata Generator (Centreon Storage)
13;rrd;RRD File Generator
30;graphite;Storage - Graphite
31;influxdb;Storage - InfluxDB

[root@localhost core]# ./centreon -u admin -p centreon -o CENTBROKERCFG -a getfieldlist -v "ipv4"
field id;short name;name
3;ca_certificate;Trusted CA's certificate;text
2;host;Host to connect to;text
46;negotiation;Enable negotiation;radio
48;one_peer_retention_mode;One peer retention;radio
1;port;Connection port;int
4;private_key;Private key file.;text
12;protocol*;Serialization Protocol;select
5;public_cert;Public certificate;text
6;tls;Enable TLS encryption;radio

Note

Note that the “protocol” entry is followed by a star. This means that you have to use one of the possible values.

This is how you get the list of possible values of a given field:

[root@localhost core]# ./centreon -u admin -p centreon -o CENTBROKERCFG -a getvaluelist -v "protocol"
possible values
ndo

The following chapters describes the parameters of each Object type

input

ipv4:

ID	Label	Description	Possible values
buffering_timeout	Buffering timeout	Time in seconds to wait before launching failover.
compression	Compression (zlib)	Enable or not data stream compression.
compression_buffer	Compression buffer size	The higher the buffer size is, the best compression. This however increase data streaming latency. Use with caution.
compression_level	Compression level	Ranges from 0 (no compression) to 9 (best compression). Default is -1 (zlib compression)
retry_interval	Retry interval	Time in seconds to wait between each connection attempt.
category	Filter category	Category filter for flux in input
ca_certificate	Trusted CA’s certificate	Trusted CA’s certificate.
host	Host to connect to	IP address or hostname of the host to connect to (leave blank for listening mode).
one_peer_retention_mode	One peer retention	This allows the retention to work even if the socket is listening
port	Connection port	Port to listen on (empty host) or to connect to (with host filled).
private_key	Private key file.	Private key file path when TLS encryption is used.
protocol	Serialization protocol	Serialization protocol.	ndo
public_cert	Public certificate	Public certificate file path when TLS encryption is used.
tls	Enable TLS encryption	Enable TLS encryption.

ipv6:

ID	Label	Description	Possible values
buffering_timeout	Buffering timeout	Time in seconds to wait before launching failover.
compression	Compression (zlib)	Enable or not data stream compression.
compression_buffer	Compression buffer size	The higher the buffer size is, the best compression. This however increase data streaming latency. Use with caution.
compression_level	Compression level	Ranges from 0 (no compression) to 9 (best compression). Default is -1 (zlib compression)
retry_interval	Retry interval	Time in seconds to wait between each connection attempt.
category	Filter category	Category filter for flux in input
ca_certificate	Trusted CA’s certificate	Trusted CA’s certificate.
host	Host to connect to	IP address or hostname of the host to connect to (leave blank for listening mode).
one_peer_retention_mode	One peer retention	This allows the retention to work even if the socket is listening
port	Connection port	Port to listen on (empty host) or to connect to (with host filled).
private_key	Private key file.	Private key file path when TLS encryption is used.
protocol	Serialization protocol	Serialization protocol.	ndo
public_cert	Public certificate	Public certificate file path when TLS encryption is used.
tls	Enable TLS encryption	Enable TLS encryption.

file:

ID	Label	Description	Possible values
buffering_timeout	Buffering timeout	Time in seconds to wait before launching failover.
compression	Compression (zlib)	Enable or not data stream compression.
compression_buffer	Compression buffer size	The higher the buffer size is, the best compression. This however increase data streaming latency. Use with caution.
compression_level	Compression level	Ranges from 0 (no compression) to 9 (best compression). Default is -1 (zlib compression)
retry_interval	Retry interval	Time in seconds to wait between each connection attempt.
max_size	Maximum size of file	Maximum size in bytes.
path	File path	Path to the file.
protocol	Serialization protocol	Serialization protocol.	ndo

logger

file:

ID	Label	Description	Possible values
config	Configuration messages	Enable or not configuration messages logging.
debug	Debug messages	Enable or not debug messages logging.
error	Error messages	Enable or not error messages logging.
info	Informational messages	Enable or not informational messages logging.
level	Logging level	How much messages must be logged.	high,low,medium
max_size	Max file size in bytes	The maximum size of log file.
name	Name of the logger	For a file logger this is the path to the file. For a standard logger, one of ‘stdout’ or ‘stderr’.

standard:

ID	Label	Description	Possible values
config	Configuration messages	Enable or not configuration messages logging.
debug	Debug messages	Enable or not debug messages logging.
error	Error messages	Enable or not error messages logging.
info	Informational messages	Enable or not informational messages logging.
level	Logging level	How much messages must be logged.	high,low,medium
name	Name of the logger	For a file logger this is the path to the file. For a standard logger, one of ‘stdout’ or ‘stderr’.

syslog:

ID	Label	Description	Possible values
config	Configuration messages	Enable or not configuration messages logging.
debug	Debug messages	Enable or not debug messages logging.
error	Error messages	Enable or not error messages logging.
info	Informational messages	Enable or not informational messages logging.
level	Logging level	How much messages must be logged.	high,low,medium

monitoring:

ID	Label	Description	Possible values
config	Configuration messages	Enable or not configuration messages logging.
debug	Debug messages	Enable or not debug messages logging.
error	Error messages	Enable or not error messages logging.
info	Informational messages	Enable or not informational messages logging.
level	Logging level	How much messages must be logged.	high,low,medium
name	Name of the logger	For a file logger this is the path to the file. For a standard logger, one of ‘stdout’ or ‘stderr’.

output

ipv4:

ID	Label	Description	Possible values
buffering_timeout	Buffering timeout	Time in seconds to wait before launching failover.
compression	Compression (zlib)	Enable or not data stream compression.
compression_buffer	Compression buffer size	The higher the buffer size is, the best compression. This however increase data streaming latency. Use with caution.
compression_level	Compression level	Ranges from 0 (no compression) to 9 (best compression). Default is -1 (zlib compression)
failover	Failover name	Name of the output which will act as failover
retry_interval	Retry interval	Time in seconds to wait between each connection attempt.
category	Filter category	Category filter for flux in output
ca_certificate	Trusted CA’s certificate	Trusted CA’s certificate.
host	Host to connect to	IP address or hostname of the host to connect to (leave blank for listening mode).
one_peer_retention_mode	One peer retention	This allows the retention to work even if the socket is listening
port	Connection port	Port to listen on (empty host) or to connect to (with host filled).
private_key	Private key file.	Private key file path when TLS encryption is used.
protocol	Serialization protocol	Serialization protocol.	ndo
public_cert	Public certificate	Public certificate file path when TLS encryption is used.
tls	Enable TLS encryption	Enable TLS encryption.

ipv6:

ID	Label	Description	Possible values
buffering_timeout	Buffering timeout	Time in seconds to wait before launching failover.
compression	Compression (zlib)	Enable or not data stream compression.
compression_buffer	Compression buffer size	The higher the buffer size is, the best compression. This however increase data streaming latency. Use with caution.
compression_level	Compression level	Ranges from 0 (no compression) to 9 (best compression). Default is -1 (zlib compression)
failover	Failover name	Name of the output which will act as failover
retry_interval	Retry interval	Time in seconds to wait between each connection attempt.
category	Filter category	Category filter for flux in output
ca_certificate	Trusted CA’s certificate	Trusted CA’s certificate.
host	Host to connect to	IP address or hostname of the host to connect to (leave blank for listening mode).
one_peer_retention_mode	One peer retention	This allows the retention to work even if the socket is listening
port	Connection port	Port to listen on (empty host) or to connect to (with host filled).
private_key	Private key file.	Private key file path when TLS encryption is used.
protocol	Serialization protocol	Serialization protocol.	ndo
public_cert	Public certificate	Public certificate file path when TLS encryption is used.
tls	Enable TLS encryption	Enable TLS encryption.

file:

ID	Label	Description	Possible values
buffering_timeout	Buffering timeout	Time in seconds to wait before launching failover.
compression	Compression (zlib)	Enable or not data stream compression.
compression_buffer	Compression buffer size	The higher the buffer size is, the best compression. This however increase data streaming latency. Use with caution.
compression_level	Compression level	Ranges from 0 (no compression) to 9 (best compression). Default is -1 (zlib compression)
failover	Failover name	Name of the output which will act as failover
retry_interval	Retry interval	Time in seconds to wait between each connection attempt.
category	Filter category	Category filter for flux in output.
max_size	Maximum size of file	Maximum size in bytes.
path	File path	Path to the file.
protocol	Serialization protocol	Serialization protocol.	ndo

rrd:

ID	Label	Description	Possible values
buffering_timeout	Buffering timeout	Time in seconds to wait before launching failover.
failover	Failover name	Name of the output which will act as failover
retry_interval	Retry interval	Time in seconds to wait between each connection attempt.
category	Filter category	Category filter for flux in output.
metrics_path	RRD file directory for metrics	RRD file directory, for example /var/lib/centreon/metrics
path	Unix socket	The Unix socket used to communicate with rrdcached. This is a global option, go to Administration > Options > RRDTool to modify it.
port	TCP port	The TCP port used to communicate with rrdcached. This is a global option, go to Administration > Options > RRDTool to modify it.
status_path	RRD file directory for statuses	RRD file directory, for example /var/lib/centreon/status
write_metrics	Enable write_metrics	Enable or not write_metrics.
write_status	Enable write_status	Enable or not write_status.
store_in_data_bin	Enable store_in_data_bin	Enable or not store in performance data in data_bin.

storage:

ID	Label	Description	Possible values
buffering_timeout	Buffering timeout	Time in seconds to wait before launching failover.
failover	Failover name	Name of the output which will act as failover
retry_interval	Retry interval	Time in seconds to wait between each connection attempt.
category	Filter category	Category filter for flux in output.
check_replication	Replication enabled	When enabled, the broker engine will check whether or not the replication is up to date before attempting to update data.
db_host	DB host	IP address or hostname of the database server.
db_name	DB name	Database name.
db_password	DB password	Password of database user.
db_port	DB port	Port on which the DB server listens
db_type	DB type	Target DBMS.	db2,ibase,mysql,oci,odbc,postgresql,sqlite,tds
db_user	DB user	Database user.
interval	Interval length	Interval length in seconds.
length	RRD length	RRD storage duration in seconds.
queries_per_transaction	Maximum queries per transaction	The maximum queries per transaction before commit.
read_timeout	Transaction commit timeout	The transaction timeout before running commit.
rebuild_check_interval	Rebuild check interval in seconds	The interval between check if some metrics must be rebuild. The default value is 300s
store_in_data_bin	Enable store_in_data_bin	Enable or not store in performance data in data_bin.

sql:

ID	Label	Description	Possible values
buffering_timeout	Buffering timeout	Time in seconds to wait before launching failover.
failover	Failover name	Name of the output which will act as failover
retry_interval	Retry interval	Time in seconds to wait between each connection attempt.
category	Filter category	Category filter for flux in output.
check_replication	Replication enabled	When enabled, the broker engine will check whether or not the replication is up to date before attempting to update data.
db_host	DB host	IP address or hostname of the database server.
db_name	DB name	Database name.
db_password	DB password	Password of database user.
db_port	DB port	Port on which the DB server listens
db_type	DB type	Target DBMS.	db2,ibase,mysql,oci,odbc,postgresql,sqlite,tds
db_user	DB user	Database user.
queries_per_transaction	Maximum queries per transaction	The maximum queries per transaction before commit.
read_timeout	Transaction commit timeout	The transaction timeout before running commit.