check_synology_volumes.md

check_synology_volumes.py

this Icinga/Nagios plugin checks the status / usage of volumes and storage pools on a Synology NAS device.

Usage

usage: check_synology_volumes.py [-h] -H HOST [-p PORT] [-t TIMEOUT] [-6] [-w WARN] [-c CRIT] [-i IGNORE_UTILIZATION] -u USER [-l {authPriv,authNoPriv}]
                                 -A AUTHKEY [-X PRIVKEY] [-a {MD5,SHA,SHA224,SHA256,SHA384,SHA512}] [-x {DES,3DES,AES,AES192,AES256}]

Icinga/Nagios plugin which checks the RAID volume state on a Synology NAS

optional arguments:
  -h, --help            show this help message and exit

Connection parameters:
  -H HOST, --host HOST  hostname or IP address
  -p PORT, --port PORT  SNMP port
  -t TIMEOUT, --timeout TIMEOUT
                        SNMP timeout
  -6, --ipv6            Use IPv6

Thresholds:
  -w WARN, --warn WARN  Volume warning threshold (in percent)
  -c CRIT, --crit CRIT  Volume critical threshold (in percent)
  -i IGNORE_UTILIZATION, --ignore-utilization IGNORE_UTILIZATION
                        Ignore utilization thresholds for volume (may be repeated)

SNMPv3 parameters:
  -u USER, --user USER  SNMPv3 user name
  -l {authPriv,authNoPriv}, --seclevel {authPriv,authNoPriv}
                        SNMPv3 security level
  -A AUTHKEY, --authkey AUTHKEY
                        SNMPv3 auth key
  -X PRIVKEY, --privkey PRIVKEY
                        SNMPv3 priv key
  -a {MD5,SHA,SHA224,SHA256,SHA384,SHA512}, --authmode {MD5,SHA,SHA224,SHA256,SHA384,SHA512}
                        SNMPv3 auth mode
  -x {DES,3DES,AES,AES192,AES256}, --privmode {DES,3DES,AES,AES192,AES256}
                        SNMPv3 privacy mode

Usage example

./check_synology_volumes.py --host 1.2.3.4 \
                            --user monitoring \
                            --authmode SHA \
                            --authkey 'ABCDEF' \
                            --privmode AES \
                            --privkey '123456' \
                            --warn 80 \
                            --crit 90

OK - Volume 1: Normal (84.88%) Storage Pool 1: Normal | 'Volume1'=45622094888960B;48376550548685;51064136690278;0;53751722831872

Parameters