glensc/ nagios-plugin-check_raid

(4.0.10) almost 2 years ago

Perl

Shell

Need help with nagios-plugin-check_raid?

Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

glensc

128 Stars

79 Forks

1.2K Commits

34 Opened issues

Description

Nagios/Icinga plugin to check current server's RAID status

Services available

Need anything else?

Contributors list

Readme

Nagios/Icinga/Sensu plugin to check current server's RAID status

Name: nagios-plugin-check_raid
Brand: nagios-plugin-check_raid
SKU: //glensc/nagios-plugin-check_raid
Rating: 2.07 (128 reviews)

This plugin checks all RAID volumes (hardware and software) that can be identified.

While written originally for Nagios, it's known to work also with: - Icinga - Sensu

This is supposed to be a general plugin to run via NRPE. It checks for the various RAID systems, and verifies they are working correctly.

Some checks require root permission, that is acomplished using

sudo

. Neccessary

sudo

rules (detected for your system), can be installed when

check_raid

is invoked with

-S

argument. You need to be

root

user and it will add required lines to the sudo config file.

Reporting bugs

IMPORTANT: See CONTRIBUTING.md what is needed for your reported Issue to be worked on or Pull Request to be accepted.

Failure to do so means I will just have to ignore your Issue or Pull Request and will eventually close with no resolution. Currently there are too many of such tickets.

Installing

Download latest release from releases page

next step would be to setup system

sudo

rules:

./check_raid.pl -S

run with

-d

to preview the sudo rules.

Plugin should be ready to be run:

./check_raid.pl

for some RAIDs there's need to install extra tools, see Supported RAIDs

Development

To obtain latest development version of the plugin source, grab tarball or do a git checkout:

git clone --depth=8 https://github.com/glensc/nagios-plugin-check_raid

to build self-contained fatpacked

check_raid.pl

, invoke

make pack

, otherwise use

check_raid.sh

in project root to run the plugin in source tree.

Usage

./check_raid.pl [-p|--plugin ] [-w|--warnonly]
./check_raid.pl -S
./check_raid.pl -l

Command line arguments

-V  --version           Print check_raid version
-d                      Produce some debug output
-S  --sudoers           Configure /etc/sudoers file
-W  --warnonly          Don't send CRITICAL status
-p  --plugin   Force the use of selected plugins, comma separated
    --noraid=STATE      Set status as STATE if RAID volumes are not found. Defaults to `UNKNOWN`
    --resync=STATE      Set status as STATE if RAID is in resync state. Defaults to `WARNING`
    --check=STATE       Set status as STATE if RAID is in check state. Defaults to `OK`
    --cache-fail=STATE  Set status as STATE if Write Cache is present but disabled. Defaults to `WARNING`
    --bbulearn=STATE    Return STATE if Backup Battery Unit (BBU) learning cycle is in progress. Defaults to `WARNING`
    --bbu-monitoring    Enable experimental monitoring of the BBU status
-l  --list-plugins      Lists active plugins

STATE

can be one of:

OK

WARNING

CRITICAL

UNKNOWN

Supported RAIDs

Supported RAIDs that can be checked:

Adaptec AAC RAID via
```
aaccli
```
or
```
afacli
```
or
```
arcconf
```
AIX software RAID via
```
lsvg
```
HP/Compaq Smart Array via
```
cciss_vol_status
```
(hpsa supported too)
HP Smart Array Controllers and MSA Controllers with
```
hpacucli
```
,
```
hpssacli
```
,
```
ssacli
```
HP Smart Array (MSA1500) via serial line
Linux 3ware SATA RAID via
```
tw_cli
```
Linux Device Mapper RAID via dmraid
Linux DPT/I2O hardware RAID controllers via
```
/proc/scsi/dpt_i2o
```
Linux GDTH hardware RAID controllers via
```
/proc/scsi/gdth
```
Linux LSI MegaRaid hardware RAID via CmdTool2
Linux LSI MegaRaid hardware RAID via megarc
Linux LSI MegaRaid hardware RAID via
```
/proc/megaraid
```
Linux Device Mapper
Linux MegaIDE hardware RAID controllers via
```
/proc/megaide
```
Linux MPT hardware RAID via mpt-status
Linux software RAID (md) via
```
/proc/mdstat
```
LSI Logic MegaRAID SAS series via MegaCli
LSI MegaRaid via lsraid
Serveraid IPS via ipssend
Solaris software RAID via metastat

You might need to install following tools depending on your raid:

```
CmdTool2
```
: CmdTool2 SAS RAID Management Utility
```
arcconf
```
: Adaptec uniform command line interface
```
cciss_vol_status
```
: http://cciss.sourceforge.net/
```
dmraid
```
: Device Mapper RAID command line interface
```
megarc-scsi
```
: LSI Logic MegaRAID Linux MegaRC utility
```
mpt-status
```
: LSI RAID controllers - http://www.red-bean.com/~mab/mpt-status.html
```
tw_cli-9xxx
```
: 3ware SATA RAID controllers - http://www.3ware.com/

Project entry in Nagios Exchange: http://exchange.nagios.org/directory/Plugins/Hardware/Storage-Systems/RAID-Controllers/check_raid/details

Copyright

License: GPL v2