check_oceanstor

Nagios plugin for monitoring Huawei OceanStor storage devices using the API

Commands implemented

• check_oceanstor_alarms.py: Checks for active alarms
• check_oceanstor_filesystems.py: Checks free space on filesystems
• check_oceanstor_diskdomains.py: Checks free space on diskdomains
• check_oceanstor_storagepools.py: Checks free space on storagepools

Just an small subset of what is possible is implemented, but it's what we need. EVERYTHING on an OceanStor can be done using the API. If not convinced, connect the browser to the device and fire up developer tools. You will see the browser is using the API for doing the job.

Google "Huawei OceanStor REST API" for the documentation

Feel free to fork and extend

Examples

• Check one filesystem, including space used for "Data Protection", aka snapshots.

check_oceanstor_filesystems.py -H <ADDRESS> -u <USER> -p <PWD> -s <SYSTEM_ID>  -n <NAME> -w 70 -c 90 -W 1 -C 1
OK: [NAME] OK
OK: filesystem NAME: size: 11264GB, used:  7259GB, pctused: 64.45% Snapshots reserved:  2253GB, used:     0GB, pctused:  0.00%
| 'NAME'=64.45% 'NAME_snapshots'= 0.00%

• Check all filesystems with name starting with "FS"

check_oceanstor_filesystems.py -H <ADDRESS> -u <USER> -p <PWD> -s <SYSTEM_ID> -n FS* -w 70 -c 90

OK: [ FSname0 FSname1 FSname2 FSname3 FSname4 FSname5 FSname6 FSname7 FSname8 FSname9] OK
OK: filesystem FSname0: size: 11264GB, used:  7550GB, pctused: 67.03% Snapshots reserved:  2253GB, used:     0GB, pctused:  0.00%
OK: filesystem FSname1: size: 11264GB, used:  7527GB, pctused: 66.82% Snapshots reserved:  2253GB, used:     0GB, pctused:  0.00%
OK: filesystem FSname2: size: 11264GB, used:  7723GB, pctused: 68.57% Snapshots reserved:  2253GB, used:     0GB, pctused:  0.00%
OK: filesystem FSname3: size: 11264GB, used:  7662GB, pctused: 68.02% Snapshots reserved:  2253GB, used:     0GB, pctused:  0.00%
OK: filesystem FSname4: size: 11264GB, used:  7705GB, pctused: 68.40% Snapshots reserved:  2253GB, used:     0GB, pctused:  0.00%
OK: filesystem FSname5: size: 11264GB, used:  6985GB, pctused: 62.01% Snapshots reserved:  2253GB, used:     0GB, pctused:  0.00%
OK: filesystem FSname6: size: 11264GB, used:  7247GB, pctused: 64.34% Snapshots reserved:  2253GB, used:     0GB, pctused:  0.00%
OK: filesystem FSname7: size: 11264GB, used:     0GB, pctused:  0.00% Snapshots reserved:  2253GB, used:     0GB, pctused:  0.00%
OK: filesystem FSname8: size: 11264GB, used:     0GB, pctused:  0.00% Snapshots reserved:  2253GB, used:     0GB, pctused:  0.00%
OK: filesystem FSname9: size: 11264GB, used:     0GB, pctused:  0.00% Snapshots reserved:  2253GB, used:     0GB, pctused:  0.00%
| 'FSname0'=67.03% 'FSname0_snapshots'= 0.00% 'FSname1'=66.82% 'FSname1_snapshots'= 0.00% 'FSname2'=68.57% 'FSname2_snapshots'= 0.00% 'FSname3'=68.02% 'FSname3_snapshots'= 0.00% 'FSname4'=68.40% 'FSname4_snapshots'= 0.00% 'FSname5'=62.01% 'FSname5_snapshots'= 0.00% 'FSname6'=64.34% 'FSname6_snapshots'= 0.00% 'FSname7'= 0.00% 'FSname7_snapshots'= 0.00% 'FSname8'= 0.00% 'FSname8_snapshots'= 0.00% 'FSname9'= 0.00% 'FSname9_snapshots'= 0.00%

• Check for alarms. The plugin returns all active alarms, with serverity

check_oceanstor_alarms.py -H <ADDRESS> -u <USER> -p <PWD> -s <SYSTEM_ID>
OK: no alarms found | alarms=0

• Performance data graph from a filesystem

• Status of a Diskdomain

Author:

Toni Comerma

CCMA, SA