{"id":16830330,"url":"https://github.com/glensc/nagios-plugin-check_raid","last_synced_at":"2025-10-06T14:50:41.698Z","repository":{"id":3398651,"uuid":"4448139","full_name":"glensc/nagios-plugin-check_raid","owner":"glensc","description":"Nagios/Icinga/Sensu plugin to check current server's RAID status ⛺","archived":false,"fork":false,"pushed_at":"2024-06-27T13:48:01.000Z","size":1752,"stargazers_count":143,"open_issues_count":40,"forks_count":86,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-05-19T11:06:43.053Z","etag":null,"topics":["icinga","icinga-plugin","monitoring","nagios","nagios-plugin","raid","sensu","sensu-plugin"],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/glensc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-05-25T17:36:18.000Z","updated_at":"2025-05-12T15:44:06.000Z","dependencies_parsed_at":"2024-10-25T18:40:12.598Z","dependency_job_id":"d92b4235-453e-4683-aba7-6397b589a99f","html_url":"https://github.com/glensc/nagios-plugin-check_raid","commit_stats":{"total_commits":1152,"total_committers":50,"mean_commits":23.04,"dds":0.2465277777777778,"last_synced_commit":"ecd8632f56cf4c200989d9f5fe2e3a9ebcf227ff"},"previous_names":[],"tags_count":42,"template":false,"template_full_name":null,"purl":"pkg:github/glensc/nagios-plugin-check_raid","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glensc%2Fnagios-plugin-check_raid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glensc%2Fnagios-plugin-check_raid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glensc%2Fnagios-plugin-check_raid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glensc%2Fnagios-plugin-check_raid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/glensc","download_url":"https://codeload.github.com/glensc/nagios-plugin-check_raid/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glensc%2Fnagios-plugin-check_raid/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278629035,"owners_count":26018480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["icinga","icinga-plugin","monitoring","nagios","nagios-plugin","raid","sensu","sensu-plugin"],"created_at":"2024-10-13T11:38:19.185Z","updated_at":"2025-10-06T14:50:41.669Z","avatar_url":"https://github.com/glensc.png","language":"Perl","funding_links":[],"categories":["Nagios Monitoring"],"sub_categories":["Nagios Monitoring Plugins"],"readme":"# Nagios/Icinga/Sensu plugin to check current server's RAID status\n\nThis plugin checks all RAID volumes (hardware and software) that can be\nidentified.\n\nWhile written originally for Nagios, it's known to work also with:\n- [Icinga](https://www.icinga.com/)\n- [Sensu](https://sensuapp.org/docs/1.0/overview/what-is-sensu.html)\n\nThis is supposed to be a general plugin to run via NRPE.\nIt checks for the various RAID systems, and verifies they are working correctly.\n\nSome checks require root permission, that is acomplished using `sudo`.\nNeccessary `sudo` rules (detected for your system), can be installed when\n`check_raid` is invoked with `-S` argument. You need to be `root` user and it\nwill add required lines to the sudo config file.\n\n[![Test suite](https://github.com/glensc/nagios-plugin-check_raid/actions/workflows/perl.yml/badge.svg?branch=master)](https://github.com/glensc/nagios-plugin-check_raid/actions/workflows/perl.yml)\n\n## Reporting bugs\n\n**IMPORTANT**: See [CONTRIBUTING.md](CONTRIBUTING.md) what is needed for your reported *Issue* to be worked on or *Pull Request* to be accepted.\n\nFailure 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](https://github.com/glensc/nagios-plugin-check_raid/labels/need%20test%20data) of such tickets.\n\n## Installing\n\nDownload latest release from [releases](https://github.com/glensc/nagios-plugin-check_raid/releases) page\n\nnext step would be to setup system `sudo` rules:\n\n    ./check_raid.pl -S\n\nrun with `-d` to preview the sudo rules.\n\nPlugin should be ready to be run:\n\n    ./check_raid.pl\n\nfor some RAIDs there's need to install extra tools, see [Supported RAIDs](#supported-raids)\n\n## Development\n\nTo obtain latest development version of the plugin source, grab [tarball](https://github.com/glensc/nagios-plugin-check_raid/archive/master/check_raid.tar.gz) or do a git checkout:\n\n    git clone --depth=8 https://github.com/glensc/nagios-plugin-check_raid\n\nto build self-contained [fatpacked](http://www.perladvent.org/2012/2012-12-14.html) `check_raid.pl`, invoke `make pack`, otherwise use `check_raid.sh` in project root to run the plugin in source tree.\n\n## Usage\n\n\t./check_raid.pl [-p|--plugin \u003cname\u003e] [-w|--warnonly]\n\t./check_raid.pl -S\n\t./check_raid.pl -l\n\nCommand line arguments\n\n\t-V  --version           Print check_raid version\n\t-d                      Produce some debug output\n\t-S  --sudoers           Configure /etc/sudoers file\n\t-W  --warnonly          Don't send CRITICAL status\n\t-p  --plugin \u003cname(s)\u003e  Force the use of selected plugins, comma separated\n\t    --noraid=STATE      Set status as STATE if RAID volumes are not found. Defaults to `UNKNOWN`\n\t    --resync=STATE      Set status as STATE if RAID is in resync state. Defaults to `WARNING`\n\t    --check=STATE       Set status as STATE if RAID is in check state. Defaults to `OK`\n\t    --cache-fail=STATE  Set status as STATE if Write Cache is present but disabled. Defaults to `WARNING`\n\t    --bbulearn=STATE    Return STATE if Backup Battery Unit (BBU) learning cycle is in progress. Defaults to `WARNING`\n\t    --bbu-monitoring    Enable experimental monitoring of the BBU status\n\t-l  --list-plugins      Lists active plugins\n\n`STATE` can be one of: `OK`, `WARNING`, `CRITICAL`, `UNKNOWN`\n\n## Supported RAIDs\n\nSupported RAIDs that can be checked:\n\n- Adaptec AAC RAID via `aaccli` or `afacli` or `arcconf`\n- AIX software RAID via `lsvg`\n- HP/Compaq Smart Array via `cciss_vol_status` (hpsa supported too)\n- HP Smart Array Controllers and MSA Controllers with `hpacucli`, `hpssacli`, `ssacli`\n- HP Smart Array (MSA1500) via serial line\n- Linux 3ware SATA RAID via `tw_cli`\n- Linux Device Mapper RAID via dmraid\n- Linux DPT/I2O hardware RAID controllers via `/proc/scsi/dpt_i2o`\n- Linux GDTH hardware RAID controllers via `/proc/scsi/gdth`\n- Linux LSI MegaRaid hardware RAID via CmdTool2\n- Linux LSI MegaRaid hardware RAID via megarc\n- Linux LSI MegaRaid hardware RAID via `/proc/megaraid`\n- Linux Device Mapper\n- Linux MegaIDE hardware RAID controllers via `/proc/megaide`\n- Linux MPT hardware RAID via mpt-status\n- Linux software RAID (md) via `/proc/mdstat`\n- LSI Logic MegaRAID SAS series via MegaCli\n- LSI MegaRaid via lsraid\n- Serveraid IPS via ipssend\n- Solaris software RAID via metastat\n\nYou might need to install following tools depending on your raid:\n\n- `CmdTool2`: CmdTool2 SAS RAID Management Utility\n- `arcconf`: Adaptec uniform command line interface\n- `cciss_vol_status`: http://cciss.sourceforge.net/\n- `dmraid`: Device Mapper RAID command line interface\n- `megarc-scsi`: LSI Logic MegaRAID Linux MegaRC utility\n- `mpt-status`: LSI RAID controllers - http://www.red-bean.com/~mab/mpt-status.html\n- `tw_cli-9xxx`: 3ware SATA RAID controllers - http://www.3ware.com/\n\nProject entry in Nagios Exchange: http://exchange.nagios.org/directory/Plugins/Hardware/Storage-Systems/RAID-Controllers/check_raid/details\n\n## Copyright\nLicense: GPL v2\n\n(c) 2004-2006 Steve Shipway (code up to version 2.1), university of auckland,\nhttp://www.steveshipway.org/forum/viewtopic.php?f=20\u0026t=417\u0026p=3211\nSteve Shipway Thanks M Carmier for megaraid section.\n\n(c) 2009-2019 Elan Ruusamäe \u003cglen@pld-linux.org\u003e (maintainer from version 2.1 and upwards)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglensc%2Fnagios-plugin-check_raid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fglensc%2Fnagios-plugin-check_raid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglensc%2Fnagios-plugin-check_raid/lists"}