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 |