Collection of standard plugins to discover and gather cloud-to-edge metrics and status across your whole IT infrastructure.
Go to file
omercier 0329aae838 add jboss jmx mbean for datasource mode
The datasource mode returned an unknown status because the datasources
were in another mbean. This addition shoud not break anything.
2020-06-30 11:16:02 +02:00
.github add issue comment 2017-06-14 11:06:52 +02:00
apps add jboss jmx mbean for datasource mode 2020-06-30 11:16:02 +02:00
blockchain/hyperledger/exporter simplify class counters naming 2020-05-13 14:18:28 +02:00
centreon enhance libssh pipe 2020-06-29 18:01:20 +02:00
cloud fix output service status skip 2020-06-16 18:04:42 +02:00
contrib enh(doc): rename /docs/ folder to /doc/ to ease generation and pimp conf.py. 2020-06-15 10:31:36 +02:00
database simplify class counters naming 2020-05-13 14:18:28 +02:00
doc enh(doc): rename /docs/ folder to /doc/ to ease generation and pimp conf.py. 2020-06-15 10:31:36 +02:00
example happy new year! 2020-01-06 15:19:23 +01:00
hardware remove useless code 2020-06-16 17:59:54 +02:00
network add paloalto mode 2020-06-29 09:24:32 +02:00
notification add missing host output to notification 2020-04-17 00:48:34 +02:00
os Fix #2007: break changes 2020-06-02 16:18:36 +02:00
snmp_standard/mode Fix #1985 2020-06-29 16:29:05 +02:00
storage fix netapp cluster mode 2020-06-24 14:42:03 +02:00
Jenkinsfile limit build history to 50 items. 2020-04-21 09:20:09 +02:00
LICENSE.txt + License now Apache 2.0 2015-07-21 11:51:02 +02:00
README.md enh(doc): rename /docs/ folder to /doc/ to ease generation and pimp conf.py. 2020-06-15 10:31:36 +02:00
centreon_plugins.pl happy new year! 2020-01-06 15:19:23 +01:00
changelog prepare release 2020-06-02 12:36:17 +02:00
sonar-project.properties add SonarQube analysis to the Jenkinsfile (#1264) 2018-12-10 11:38:29 +01:00

README.md

centreon-plugins

License GitHub stars GitHub forks

“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 'user/guide.rst' or go to https://docs.centreon.com/docs/centreon-plugins/en/latest/