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
Monitoring Engine Engine used on poller: NAGIOS, ICINGA, SHINKEN...
Bin Path of the Scheduler binary
Stats Bin Path of the Nagios Stats binary
Perfdata Path of perfdata file
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
Monitoring Engine Engine used on poller: NAGIOS, ICINGA, SHINKEN

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  
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
init_script Init script path
monitoring_engine Engine used on poller: NAGIOS, ICINGA, SHINKEN
nagios_bin Path of the Scheduler binary
nagiostats_bin Path of the Nagios Stats binary
nagios_perfdata Path of perfdata file
ssh_port SSH Port
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