centreon-plugins/centreon-plugins
Simon Bomm 316e0244d3 Getting rid of single quote in instance filter (#3879) 2022-09-06 10:45:53 +02:00
..
.github 🚧 fix(chore): remove github action (#3175) 2021-10-05 21:05:19 +02:00
apps Getting rid of single quote in instance filter (#3879) 2022-09-06 10:45:53 +02:00
blockchain update copyright - happy new year (#3375) 2022-01-04 14:55:10 +01:00
centreon (plugin) network::cisco::standard::snmp - mode environment add option --add-fru-power (#3877) 2022-09-01 17:13:44 +02:00
cloud (plugin) cloud::azure::managemement::budgets - Add cost management plugin (#3866) 2022-09-05 13:16:46 +02:00
contrib clean(plugin): some mode missing + update check_plugins script (#3337) 2021-12-22 13:10:14 +01:00
database add ssl option eval system (#3853) 2022-08-19 15:04:09 +02:00
doc (doc) convert to markdown english guide.md (#3625) 2022-05-02 16:43:10 +02:00
example update copyright - happy new year (#3375) 2022-01-04 14:55:10 +01:00
hardware (plugin) hardware::server::dell::vxm::restapi - add default curl backend (#3801) 2022-08-02 14:58:40 +02:00
network (plugin) network::oneaccess::snmp - add rtt-probes mode (#3874) 2022-09-01 11:15:14 +02:00
notification (plugin) notification::microsoft::office365::teams::plugin - adding redirection to newer resource status pages (#3863) 2022-08-25 17:12:28 +02:00
os plugin) os::linux::local - change snmp discovery extra-oids format (#3876) 2022-09-02 09:23:21 +02:00
snmp_standard/mode snmp_standard::mode::storage - empty --filter-storage-type option (#3795) 2022-08-01 10:18:13 +02:00
storage (plugin) storage::emc::vplex::restapi - default backend curl (#3881) 2022-09-05 15:37:52 +02:00
Jenkinsfile Reduce number of // curl command to avoid sonar kuff (#3834) 2022-08-16 09:01:49 +02:00
LICENSE.txt
README.md enh(doc) spelling ux (#3315) 2021-12-11 09:22:35 +01:00
centreon_plugins.pl update copyright - happy new year (#3375) 2022-01-04 14:55:10 +01:00
changelog prepare release 20220616 (#3743) 2022-06-16 09:01:36 +02:00
sonar-project.properties enh(chore): integrate sonarQube dev edition (#2937) 2021-07-06 10:14:28 +02:00

README.md

centreon-plugins

License

Contributors Stars Forks Issues

“centreon-plugins” is a free and open source project to monitor systems. The project can be used with Centreon and all monitoring softwares compatible with Nagios plugins.

You can monitor many systems:

  • application: Apache, Asterisk, Elasticsearch, Github, Jenkins, Kafka, Nginx, Pfsense, Redis, Tomcat, Varnish,...
  • cloud: AWS, Azure, Docker, Office365, Nutanix, Prometheus,...
  • database: Firebird, Informix, MS SQL, MySQL, Oracle, Postgres, Cassandra
  • hardware: printers (rfc3805), UPS (Powerware, Mge, Standard), Sun Hardware, Cisco UCS, SensorIP, HP Proliant, HP Bladechassis, Dell Openmanage, Dell CMC, Raritan,...
  • network: Aruba, Brocade, Bluecoat, Brocade, Checkpoint, Cisco AP/IronPort/ASA/Standard, Extreme, Fortigate, H3C, Hirschmann, HP Procurve, F5 BIG-IP, Juniper, PaloAlto, Redback, Riverbed, Ruggedcom, Stonesoft,...
  • os: Linux (SNMP, NRPE), Freebsd (SNMP), AIX (SNMP), Solaris (SNMP)...
  • storage: EMC Clariion, Netapp, Nimble, HP MSA p2000, Dell EqualLogic, Qnap, Panzura, Synology...

Basic Usage

We'll use a basic example to show you how to monitor a system. I have finished the install section and I want to monitor a Linux in SNMP. First, I need to find the plugin to use in the list:

$ perl centreon_plugins.pl --list-plugin | grep -i linux | grep 'PLUGIN'
PLUGIN: os::linux::local::plugin
PLUGIN: os::linux::snmp::plugin

It seems that 'os::linux::snmp::plugin' is the good one. So I verify with the option --help to be sure:

$ perl centreon_plugins.pl --plugin=os::linux::snmp::plugin --help
...
Plugin Description:
  Check Linux operating systems in SNMP.

It's exactly what I need. Now I'll add the option --list-mode to know what can I do with it:

$ perl centreon_plugins.pl --plugin=os::linux::snmp::plugin --list-mode
...
Modes Available:
 processcount
 time
 list-storages
 disk-usage
 diskio
 uptime
 swap
 cpu-detailed
 load
 traffic
 cpu
 inodes
 list-diskspath
 list-interfaces
 packet-errors
 memory
 tcpcon
 storage

I would like to test the 'load' mode:

$ perl centreon_plugins.pl --plugin=os::linux::snmp::plugin --mode=load
UNKNOWN: Missing parameter --hostname.

It's not working because some options are missing. I can have a description of the mode and options with the option --help:

$ perl centreon_plugins.pl --plugin=os::linux::snmp::plugin --mode=load --help

Eventually, I have to configure some SNMP options:

$ perl centreon_plugins.pl --plugin=os::linux::snmp::plugin --mode=load --hostname=127.0.0.1 --snmp-version=2c --snmp-community=public
OK: Load average: 0.00, 0.00, 0.00 | 'load1'=0.00;;;0; 'load5'=0.00;;;0; 'load15'=0.00;;;0;

I can set threshold with options --warning and --critical:

$ perl centreon_plugins.pl --plugin=os::linux::snmp::plugin --mode=load --hostname=127.0.0.1 --snmp-version=2c --snmp-community=public --warning=1,2,3 --critical=2,3,4
OK: Load average: 0.00, 0.00, 0.00 | 'load1'=0.00;0:1;0:2;0; 'load5'=0.00;0:2;0:3;0; 'load15'=0.00;0:3;0:4;0;

For more information or help, please read 'doc/en/user/guide.rst'.