https://github.com/mkorthof/check_ibm_storwize
IBM Storwize & FlashSystem Nagios check
https://github.com/mkorthof/check_ibm_storwize
array check cluster flashsystem ibm iscsi mdisk monitor nagios nrpe perl pool quorum storage storwize v7000 volume
Last synced: 9 months ago
JSON representation
IBM Storwize & FlashSystem Nagios check
- Host: GitHub
- URL: https://github.com/mkorthof/check_ibm_storwize
- Owner: mkorthof
- License: gpl-2.0
- Created: 2021-01-16T21:01:11.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-04-07T14:06:40.000Z (about 3 years ago)
- Last Synced: 2025-09-01T06:39:06.521Z (10 months ago)
- Topics: array, check, cluster, flashsystem, ibm, iscsi, mdisk, monitor, nagios, nrpe, perl, pool, quorum, storage, storwize, v7000, volume
- Language: Perl
- Homepage:
- Size: 6.46 MB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: LICENSE
Awesome Lists containing this project
README
# IBM Storwize and FlashSystem Monitoring plugin
Checks overal health of IBM FlashSystem family devices (formerly Storwize). Includes storage, network and cluster status.
https://en.wikipedia.org/wiki/IBM_FlashSystem
https://en.wikipedia.org/wiki/IBM_Storwize
## Updated version
Main additions and changes:
- script modified for standard Nagios
- supports V7000 (Gen3) and iSCSI
- tested plugin with Spectrum Virtualize upgrade v8.3.1 code (and previous versions)
- template cfg files adapted to work as best posible with Nagios Core
- configurable critical/warning thresholds, with defaults
Original script was made for "Shinken", a Nagios rewrite. This version is a fork, for more information see: [docs/Sources.md](docs/Sources.md).
## Installation
### Requirements
- Nagios, Icinga or other compatible monitoring system
- Perl 5, if not already included with OS (`apt` or `yum install perl`)
- open CIM port (TCP/5989) and a WBEM/CIM client (`apt` or `yum install sblim-wbemcli`)
- a "monitor" user account to log in to storage device (create in GUI or `mkuser` in CLI)
### Download
If you dont want to use git, get a [tarball](https://github.com/mkorthof/check_ibm_storwize/archive/refs/heads/master.tar.gz) or [zip](https://github.com/mkorthof/check_ibm_storwize/archive/refs/heads/master.zip) archive. Or, if you only want the script get [libexec/check_ibm_storwize.pl](/libexec/check_ibm_storwize.pl).
### Script
The main updated Perl script is located in "libexec" dir. Copy it to the host where you want to run it and which has access to the IBM storage device, for example your Nagios server.
#### Example
`check_ibm_storwize.pl -H ibm01.example.com -P 5988 -u nagios -p -C StorageVolume`
#### Usage
`check_ibm_storwize.pl -h`
```
IBM Storwize & FlashSystem health status plugin for Nagios (v20221223-mk)
Needs 'wbemcli' to query the Storwize Arrays CIMOM server
Usage: check_ibm_storwize.pl [-h] -H host [-P port] -u user -p password -C check [-c crit] [-w warn]
Flags:
-C check Check to run. Currently available checks:
Array, ArrayBasedOnDiskDrive*, BackendVolume, Cluster, ConcreteStoragePool**,
DiskDrive, Enclosure, EthernetPort, FCPort, IOGroup*, IsSpare, MasterConsole,
MirrorExtent, Node, QuorumDisk, StorageVolume**
BackendController, BackendTargetSCSIProtocolEndpoint, FCPortStatistics
IPProtocolEndpoint, iSCSIProtocolEndpoint*, ProtocolController*, RemoteCluster,
HostCluster
-h Print this help message
-H host Hostname of IP of the SVC cluster
-P port CIMOM port on the SVC cluster
-p Password for CIMOM access on the SVC cluster
-u User with CIMOM access on the SVC cluster
-c crit Critical threshold as NOK items or as % (only for checks with '*' or '**')
-w warn Warning threshold as NOK items or as % (only for checks with '*' or '**')
-s skip Skip element(s) using regular expression
-b bytes Do not convert bytes to MiB GiB TiB
```
## Defaults
- CIMON port 5989 (TLS)
- Convert bytes to MiB GiB TiB is enabled
Check thresholds:
- ArrayBasedOnDiskDrive - Spares: **0** ("no Spare", omit)
- ConcreteStoragePool - PhysicalCapacity: WARN at **80**% usage, CRITICAL at **90**%
- IOGroup - FreeMemory: **0** Bytes (omit)
- iSCSIProtocolEndpoint: WARN at **1** port down, **2** or more is CRITICAL
- ProtocolController: WARN at **3** hosts down, **4** or more is CRITICAL
- StorageVolume - Capacity: WARN at **85**% usage, CRITICAL at **95**%
The **bold** numbers can be changed with `-c` and `-w`. If percentage `-c 100` is set, the plugin will warn only.
These checks will WARN if more than **half** of total items are down: BackendVolume, EthernetPort and FCPort.
## Nagios templates
All nagios config file examples are now in "[etc](etc/objects)" dir. Use as you see fit.
- etc/objects/commands.cfg (check_commands)
- etc/objects/discovery.cfg (mgmt https check)
- etc/objects/template.cfg (host, user, password)
- etc/objects/timeperiods.cfg (schedule, retries)
- etc/objects/services/*.cfg
## More information
See: [docs/README.md](docs/README.md)