check_ups_health
Description
check_ups_health was developed with the goal of providing a single tool for all aspects of uninterruptible power supply (UPS) monitoring.
Motivation
Instead of installing a variety of plugins for monitoring uptime, hardware, sensors, batteries, etc., and doing so for each manufacturer, check_ups_health should be the only plugin needed.
Documentation
Supported Devices
| hardware-health | battery-health | uptime | ||
|---|---|---|---|---|
| APC | Galaxy | X | X | X |
| Socomec | Netys | X | X | X |
| Socomec | Netvision | X | X | X |
| Eaton | X | X | X | |
| Syrius | CS121 | X | X | X |
| Syrius | CS131 | X | X | X |
| Merlin Gerin | X | X | X | |
| XUPS MIB | X | X | X | |
| UPS MIB | X | X | X | |
| UPS V4 MIB | X | X | X | |
| XPCC MIB | X | X | X |
The list is not exhaustive. Some UPS devices not listed here may be recognized based on the implemented MIBs. Just try it out…
Command line parameters
- --hostname <hostname or ip> The hostname or IP address
- --community <snmpv2-community> SNMP community string
- --mode <mode> The monitoring mode
- --warning <range> Warning threshold
- --critical <range> Critical threshold
Modes
| Keyword | Meaning |
|---|---|
| hardware-health | Checks the UPS hardware status |
| battery-health | Checks battery status and capacity |
| uptime | Measures how long the UPS has been running |
Examples
Basic hardware check:
nagios$ check_ups_health --hostname 192.168.1.100 --community public --mode hardware-health
OK - UPS hardware working fine
Check battery health:
nagios$ check_ups_health --hostname 192.168.1.100 --community public --mode battery-health
OK - battery capacity is 95%
Check uptime:
nagios$ check_ups_health --hostname 192.168.1.100 --community public --mode uptime
OK - uptime is 42 days
Download
Go to Github, clone and build.
Changelog
You can find the changelog here.
Copyright
Gerhard Lausser
Check_ups_health is released under the GNU General Public License. GNU GPL
Author
Gerhard Lausser gerhard.lausser@consol.de