← ClaudeAtlas

infra-storage-check-zpoolslisted

Use when monitoring ZFS pool health or running scrubs from a machine, script, or timer - checking capacity, read/write/checksum errors, device faults, or scrub age; sending pool alerts by email; installing a monitoring daemon as a systemd service; or scripting any of that against JSON output. Covers install (uvx/uv/pip and an isolated production install), the layered configuration and its six sections, every subcommand, exit codes, and the library API. Prefer this over hand-rolling `zpool status` parsing, a scrub-plus-sleep shell loop, or a cron job that greps text.
bitranox/bitranox-skills · ★ 1 · AI & Automation · score 57
Install: claude install-skill bitranox/bitranox-skills
# check_zpools Monitors ZFS pools and alerts on them. Reads `zpool status -j --json-int` (never scrapes text), checks pools against configured thresholds, emails alerts with deduplication, runs scrubs, and can run continuously as a systemd daemon. **Requires OpenZFS 2.3 or newer** - that is the binding constraint, not the operating system. `zpool status -j --json-int` is what everything here reads, and the `-j` JSON interface arrived in OpenZFS 2.3; on anything older the command exits non-zero and no subcommand that touches a pool can work. Verify with `zpool status -j > /dev/null`. Linux and FreeBSD are the native homes. macOS works through the third-party OpenZFS on macOS port, and on Windows ZFS is not native at all - the OpenZFS on Windows driver is still beta, so WSL is the practical route there. Both ports track upstream but lag it, so check the 2.3 requirement on either rather than assuming it. Python 3.10+. Two commands are narrower than the rest: `service-install` needs systemd, and `alias-create` is Linux-only. Everything else runs wherever a readable pool does - so on FreeBSD, macOS or WSL, drop those two lines from the install sequence below and schedule the check with whatever that host uses (cron, launchd, a timer of its own). ## Install Zero-install, always newest - the form used by cron jobs and timers: ```bash uvx check_zpools@latest check ``` Persistent tool install: ```bash uv tool install check_zpools # or: pipx install check_zpools pip insta