Release v1.2.0

Merge pull request #8 from VGavara/master

CHANGELOG.md

@@ -1,9 +1,19 @@
 # Monitoring Plugins changelog
 
 - [Version 1](#version-1)
+  * [Release 1.2.0](##release-v1.2.0)
+  * [Release 1.1.0](##release-v1.1.0)
   * [Release 1.0.0](##release-v1.0.0)
-
+  
 # Version 1
 
+## Release v1.2.0
+- check_upsv4 plugins added
+- Documentation of check_ups and check_cisco plugins improved
+
+## Release v1.1.0
+- check_cisco plugins added
+- Documentation of check_ups plugins improved
+
 ## Release v1.0.0
 - Initial release with check_ups plugins

README.md

@@ -6,8 +6,9 @@ This repository contains a collection of check plugins for Nagios-compatible mon
 
 The plugins are organized in these categories:
 
-- check_ups: Plugins for monitoring devices supporting the MIB UPS (RFC 1628).
-- check_cisco: Plugins for monitoring Cisco devices.
+- `check_cisco`: Plugins for monitoring Cisco devices.
+- `check_ups`: Plugins for monitoring UPSs supporting the MIB UPS (RFC 1628).
+- `check_upsv4`: Plugins for monitoring UPSs supporting the MIB UPSv4 (DeltaUPS-MIB).
 
 # Contributions to the project
 In case you were interested in participating in this project, read [CONTRIBUTING.md](https://github.com/VGavara/monitoring-plugins/tree/stable/CONTRIBUTING.md) for further information.

src/check_cisco/README.md

@@ -0,0 +1,12 @@
+# check_cisco plugins
+
+Suite of plugins for monitoring Cisco devices supporting SNPM. Specifically, the suite is composed by:
+
+* `check_cisco_ce_alarms`: Checks the alarms on a CISCO-CONTENT-ENGINE-MIB compliant device.
+* `check_cisco_cpu`: Checks the CPU load (in percent) on a CISCO-PROCESS-MIB or OLD-CISCO-CPU-MIB SNMP compliant device.
+* `check_cisco_cras_sesions`: Checks the number of active sessions on a Cisco Remote Access Server supporting the ciscoRemoteAccessMonitorMIB MIB.
+* `check_cisco_envmon`: Checks the enviroment sensors on a CISCO-ENVMON-MIB compliant device.
+* `check_cisco_fru_fan`: Checks the fans of a CISCO-ENTITY-FRU-CONTROL-MIB compliant device (Cisco Catalyst switches, routers, ASA, MDS 9000 series, ...).
+* `check_cisco_fru_module`: Checks the modules status on a CISCO-ENTITY-FRU-CONTROL-MIB compliant device (Cisco Catalyst switches, routers, ASA, MDS 9000 series, ...)
+* `check_cisco_fru_ps`: Checks power on a CISCO-ENTITY-FRU-CONTROL-MIB compliant device (Cisco Catalyst switches, routers, ASA, MDS 9000 series, ...)
+* `check_cisco_memory`: Checks the used and fragmented memory on a CISCO_MEMORY_POOL_MIB SNMP compliant device.

src/check_cisco/check_cisco_memory/README.md

@@ -1,6 +1,6 @@
 # check_cisco_memory
 
-Checks the used and fragmented memory  on a CISCO_MEMORY_POOL_MIB SNMP compliant device.
+Checks the used and fragmented memory on a CISCO_MEMORY_POOL_MIB SNMP compliant device.
 
 # Usage
 

src/check_ups/README.md

@@ -0,0 +1,9 @@
+# check_ups plugins
+
+Suite of plugins for monitoring UPSs supporting SNPM and RFC1628 (UPS-MIB). Specifically, the suite is composed by:
+
+* `check_ups_alarms`: Checks the active UPS alarms.
+* `check_ups_battery_values`: Checks the UPS battery values (voltage, current and temperature).
+* `check_ups_inputs`: Checks the UPS power input levels (voltage, current and power).
+* `check_ups_mode`: Checks the UPS working mode (online, bypass or offline, with batteries normal, low or depleted).
+* `check_ups_outputs`: Checks the UPS output levels (voltage, current, power and load percent).

src/check_upsv4/README.md

@@ -0,0 +1,8 @@
+# check_upsv4
+
+Suite of plugins for monitoring UPSs supporting SNPM and MIB UPSv4 (DeltaUPS-MIB). Specifically, the suite is composed by:
+
+* `check_upsv4_alarms`: Checks the active UPS alarms.
+* `check_upsv4_batteryage`: Checks the batteries age and condition.
+* `check_upsv4_inputs`: Checks the input levels (frequency, voltage and/or current).
+* `check_upsv4_mode`: Checks the UPS working mode (online, bypass or offline, with batteries normal, low or depleted).

src/check_upsv4/check_upsv4_alarms/README.md

@@ -0,0 +1,19 @@
+# check_upsv4_alarms
+
+This plugin checks the active UPS alarms of a MIB UPSv4 (DeltaUPS-MIB) SNMP compliant device.
+
+# Usage
+
+    check_upsv4_alarms -H <hostname> -w <warning list> -c <critical list>
+        [-C <SNMP Community>]  [E <SNMP Version>] [-P <SNMP port>]
+        [-V <version>]
+
+Type `check_upsv4_alarms --help` for getting more info.
+
+# Examples
+## check_upsv4_alarms -H 192.168.0.1 -w 1..5,10 -c 5..10
+Checks in a MIB UPSv4 SNMP compliant device with IP address 192.168.0.1, if any of the alarms passed in the -w and -c arguments are active.
+
+It returns WARNING if one or more alarms from 1 to 5 or 10 are active, or CRITICAL if one or more alarms from 5 to 10 are active. If not active alarms are found, or their id is greater than 10 it returns OK.
+
+If the state is WARNING or CRITICAL it returns a list of active alarm id's and descriptions.