Select Supported Platforms

Select Supported Architectures

Select Tier

Github Name

This asset is forked from an upstream project at that does not yet exist as a Bonsai asset.

v2.1.1 · public · Published over 4 years ago

Asset Definition
Release Notes
Release Assets


Sensu plugin for zfs health checks.

Build Status
Gem Version
Dependency Status
Community Slack



This checks does the following checks against one or more zpools.

  • Check state
  • Check vdev errors
  • Check capacity
  • Check that a scrub has been run recently

The following flags can be used to configure the checks.

  • -z, --zpool What zpool to check. If omitted, we check all zpools.
  • -c, --capacity-warn Capacity threshold for when to warn. (default 80)
  • -C, --capacity-crit Capacity threshold for when to crit. (default 90)
  • -s, --scrubbing-interval Warn when it is more than this number of days since last scrub. (default 7)



Reads /proc/spl/kstat/zfs/arcstats for ARC statistics and puts them in a form usable by Graphite.

For more information see ZoL Linux Module Parameters


Installation and setup


At this time ideas for additional checks/metrics would be very much appreciated.

I have a few ideas that would be nice:

  • [x] Check for zpool state
  • [x] Check for vdev errors
  • [x] Check for pool capacity
  • [x] Check that disks have been scrubbed recently
  • [ ] Metric for disk utilization

Bug reports and pull requests are welcome on GitHub at


The gem is available as open source under the terms of the MIT License.

Are you sure you want to report this asset?

Please describe the reason for reporting this asset. Our moderators will be notified and will disable the asset if it is found to be inappropriate.


You must be signed in to report this asset.

Sign In with Github



Either download the source code:

Download Source

Or download the asset definition: