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 |
|
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 |
nagios_bin |
Path of the Scheduler binary |
nagiostats_bin |
Path of the Nagios Stats binary |
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 |