mirror of
https://github.com/centreon/centreon-plugins.git
synced 2025-07-31 01:24:35 +02:00
55e796633a
[xxxcdn]# /usr/lib/centreon/plugins//centreon-plugins/centreon_plugins.pl --plugin=cloud::azure::network::cdn::plugin --custommode='api' --list-mode
Plugin Description:
Check Microsoft Azure CDP profile service.
Global Options:
--mode Choose a mode.
--dyn-mode
Specify a mode with the path (separated by '::').
--list-mode
List available modes.
--mode-version
Check minimal version of mode. If not, unknown error.
--version
Display plugin version.
--custommode
Choose a custom mode.
--list-custommode
List available custom modes.
--multiple
Multiple custom mode objects (required by some specific modes)
--pass-manager
Use a password manager.
Modes Meta:
multi
Modes Available:
discovery
hit-ratio
latency
request
response
[xxxcdn]# /usr/lib/centreon/plugins//centreon-plugins/centreon_plugins.pl --plugin=cloud::azure::network::cdn::plugin --custommode='api' --mode='discovery' --subscription='xxx' --tenant='xxx' --client-id='xxx' --client-secret='' --resource-group='xxx'
{"end_time":1621344000,"start_time":1621344000,"duration":0,"discovered_items":1,"results":[{"location":"global","sku":[{"value":"Standard_Microsoft","key":"name"}],"name":"xxx","resourceGroup":"xxx","type":"microsoft.cdn/profiles","id":"/subscriptions/xxx/resourceGroups/xxx/providers/microsoft.cdn/profiles/xxx","tags":[]}]}
[xxxcdn]# /usr/lib/centreon/plugins//centreon-plugins/centreon_plugins.pl --plugin=cloud::azure::network::cdn::plugin --custommode='api' --mode='hit-ratio' --subscription='xxx' --tenant='xxx' --client-id='xxx' --client-secret='' --resource-group='xxx' --resource='xxx'
OK: Instance 'xxx' Statistic 'average' Metrics Byte Hit Ratio: 95.27% | 'xxx~average#cdn.byte.hit.percentage'=95.27%;;;0;100
[xxxcdn]# /usr/lib/centreon/plugins//centreon-plugins/centreon_plugins.pl --plugin=cloud::azure::network::cdn::plugin --custommode='api' --mode='latency' --subscription='xxx' --tenant='xxx' --client-id='xxx' --client-secret='***' --resource-group='xxx' --resource='xxx'
OK: Instance 'xxx' Statistic 'average' Metrics Total Latency: 1428.45ms | 'xxx~average#cdn.latency.total.milliseconds'=1428.45ms;;;0;
[xxxcdn]# /usr/lib/centreon/plugins//centreon-plugins/centreon_plugins.pl --plugin=cloud::azure::network::cdn::plugin --custommode='api' --mode='request' --subscription='xxx' --tenant='xxx' --client-id='xxx' --client-secret='***' --resource-group='xxx' --resource='xxx'
OK: Instance 'xxx' Statistic 'count' Metrics Request count: 118.00 | 'xxx~count#cdn.request.count'=118.00;;;0;
[xxxcdn]# /usr/lib/centreon/plugins//centreon-plugins/centreon_plugins.pl --plugin=cloud::azure::network::cdn::plugin --custommode='api' --mode='response' --subscription='xxx' --tenant='xxx' --client-id='xxx' --client-secret='***' --resource-group='xxx' --resource='xxx'
OK: Instance 'xxx' Statistic 'average' Metrics Response Size: 1092832.38Bytes | 'xxx~average#cdn.response.size'=1092832.38Bytes;;;0;
centreon-plugins
“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'.