peterpakos/check_perccli

Nagios/Opsview plugin to check status of PowerEdge RAID Controller

check_perccli

Nagios/Opsview plugin to check status of PowerEdge RAID Controller

The script connects via SSH to a machine with an installed PERC card, runs PERCCLI utility then parses its output.

If you spot a problem or have an improvement idea then feel free to open an issue and I will be glad to look into it for you.

Installation

The machine which is being monitored needs to have PERCCLI (successor to MegaCLI) installed. It's a command line tool to manage and monitor Dell RAID controllers. The utility is available for VMware, Linux and Windows systems.

The script check_perccli is normally copied to Nagios/Opsview plugins directory (/usr/local/nagios/libexec/).

Usage

Sample output - no issues detected:

$ check_perccli -H esxi01.example.com -p password
OK - C0: Optimal, PD0: Onln, PD1: Onln, PD2: Onln, PD3: Onln, PD4: Onln, PD5: Onln, VD0: Optl, VD1: Optl, BBU: Optimal
$ echo $?
0

Sample output - drive rebuilding, virtual drive degraded:

$ check_perccli -H esxi01.example.com -p password
WARNING - C0: Optimal, PD0: Onln, PD1: Rbld, PD2: Onln, PD3: Onln, PD4: Onln, PD5: Onln, VD0: Dgrd, VD1: Optl, BBU: Optimal
$ echo $?
1

Debug output:

$ check_perccli -H esxi01.example.com -p password --debug
2019-06-18 22:21:33 [check_perccli] DEBUG Namespace(debug=True, host='esxi01.example.com', password='password', perccli_path='/opt/lsi/perccli/perccli', port='22', ssh_key='~/.ssh/id_rsa', username='root', verbose=False)
2019-06-18 22:21:34 [check_perccli] DEBUG SSH connection established
2019-06-18 22:21:35 [check_perccli] DEBUG Controllers: 1
2019-06-18 22:21:35 [check_perccli] DEBUG C0: PERC H710 Adapter (Optimal)
2019-06-18 22:21:35 [check_perccli] DEBUG C0 Physical Drives: 6
2019-06-18 22:21:35 [check_perccli] DEBUG C0 PD0: TOSHIBA HDWD130 2.728 TB (Onln)
2019-06-18 22:21:35 [check_perccli] DEBUG C0 PD1: TOSHIBA HDWD130 2.728 TB (Onln)
2019-06-18 22:21:35 [check_perccli] DEBUG C0 PD2: TOSHIBA HDWD130 2.728 TB (Onln)
2019-06-18 22:21:35 [check_perccli] DEBUG C0 PD3: TOSHIBA HDWD130 2.728 TB (Onln)
2019-06-18 22:21:35 [check_perccli] DEBUG C0 PD4: SATA SSD 893.75 GB (Onln)
2019-06-18 22:21:35 [check_perccli] DEBUG C0 PD5: SATA SSD 893.75 GB (Onln)
2019-06-18 22:21:35 [check_perccli] DEBUG C0 Virtual Drives: 2
2019-06-18 22:21:35 [check_perccli] DEBUG C0 VD0: RAID10 (Optl)
2019-06-18 22:21:35 [check_perccli] DEBUG C0 VD1: RAID1 (Optl)
2019-06-18 22:21:35 [check_perccli] DEBUG C0 BBU (Optimal)
2019-06-18 22:21:35 [check_perccli] INFO OK - C0: Optimal, PD0: Onln, PD1: Onln, PD2: Onln, PD3: Onln, PD4: Onln, PD5: Onln, VD0: Optl, VD1: Optl, BBU: Optimal

Help

$ check_perccli --help
usage: check_perccli [-v] [-h] [--debug] [--verbose] -H HOST [-P PORT]
                     [-u USERNAME] [-p PASSWORD] [-k SSH_KEY]
                     [-c PERCCLI_PATH]

Nagios/Opsview plugin to check status of PowerEdge RAID Controller

optional arguments:
  -v, --version         show program's version number and exit
  -h, --help            show this help message and exit
  --debug               debugging mode
  --verbose             verbose debugging mode
  -H HOST, --host HOST  server hostname or IP address
  -P PORT, --port PORT  SSH port (default: 22)
  -u USERNAME, --username USERNAME
                        SSH username (default: root)
  -p PASSWORD, --password PASSWORD
                        SSH password (overrides publickey auth)
  -k SSH_KEY, --ssh-key SSH_KEY
                        SSH private key (default: ~/.ssh/id_rsa)
  -c PERCCLI_PATH, --perccli-path PERCCLI_PATH
                        Path to perccli (default: /opt/lsi/perccli/perccli)

check_perccli's Issues

No json decoded

./check_perccli --host 10.10.10.1 -u monitor -p monitor
UNKNOWN - PERCCLI output parsing error: No JSON object could be decoded

SSH format error

./check_perccli --host 10.10.10.1 --port 22
UNKNOWN - SSH connection error: %d format: a number is required, not str