Instances (Pollers)

Overview

Object name: INSTANCE

Show

In order to list available instances, use the SHOW action:

[root@centreon ~]# ./centreon -u admin -p centreon -o INSTANCE -a show
id;name;localhost;ip address;activate;status;init script;monitoring engine;bin;stats bin;perfdata;ssh port
1;Central;1;127.0.0.1;1;0;/etc/init.d/nagios;NAGIOS;/usr/local/nagios/bin/nagios;/usr/local/nagios/bin/nagiostats;/usr/local/nagios/var/service-perfdata;22
[...]

Columns are the following:

Column

Description

ID

ID

Name

Name

Localhost

1 if it is the main poller, 0 otherwise

IP Address

IP address of the poller

Activate

1 if poller is enabled, 0 otherwise

Status

1 if poller is running, 0 otherwise

Init script

Init script path

Bin

Path of the Scheduler binary

Stats Bin

Path of the Nagios Stats binary

SSH Port

SSH Port

Add

In order to add an instance you use the ADD action:

[root@centreon ~]# ./centreon -u admin -p centreon -o INSTANCE -a add -v "Poller test;10.30.2.55;22;NAGIOS"

Required fields are:

Column

Description

Name

Address

IP address of the poller

SSH Port

SSH port

Del

If you want to remove an instance, use the DEL action. The Name is used for identifying the instance to delete:

[root@centreon ~]# ./centreon -u admin -p centreon -o INSTANCE -a del -v "Poller test"

Setparam

If you want to change a specific parameter of an instance, use the SETPARAM command. The Name is used for identifying the instance to update:

[root@centreon ~]# ./centreon -u admin -p centreon -o INSTANCE -a setparam -v "Poller test;ns_ip_address;10.30.2.99"

Arguments are composed of the following columns:

Order

Column description

1

Name of instance

2

Parameter name

3

Parameter value

Parameters that you may change are:

Column

Description

name

Name of the poller

localhost

1 if it is the main poller, 0 otherwise

ns_ip_address

IP address of the poller

ns_activate

1 if poller is enabled, 0 otherwise

engine_start_command

Command to start Centreon Engine process

engine_stop_command

Command to stop Centreon Engine process

engine_restart_command

Command to restart Centreon Engine process

engine_reload_command

Command to reload Centreon Engine process

nagios_bin

Path of the Scheduler binary

nagiostats_bin

Path of the Nagios Stats binary

ssh_port

SSH Port

broker_reload_command

Command to reload Centreon Broker process

centreonbroker_cfg_path

Centreon Broker Configuration path

centreonbroker_module_path

Centreon Broker Module path

Gethosts

If you want to list all hosts that are monitored by a poller, use the GETHOSTS action. The Name is used for identifying the instance to query:

[root@centreon ~]# ./centreon -u admin -p centreon -o INSTANCE -a GETHOSTS -v "Poller test"
14;Centreon-Server;127.0.0.1
17;srv-website;10.30.2.1

Returned info is the following:

Order

Description

1

Host ID

2

Host name

3

Host address