The Sensu disk usage check is a Sensu Check that reports on disk usage
allowing for the inclusion or exclusion of certain file systems and/or file
Cross platform disk usage check for Sensu Usage: check-disk-usage [flags] check-disk-usage [command] Available Commands: help Help about any command version Print the version number of this plugin Flags: -i, --include-fs-type strings Comma separated list of file system types to check -e, --exclude-fs-type strings Comma separated list of file system types to exclude from checking -I, --include-fs-path strings Comma separated list of file system paths to check -E, --exclude-fs-path strings Comma separated list of file system paths to exclude from checking -w, --warning float Warning threshold for file system usage (default 85) -c, --critical float Critical threshold for file system usage (default 95) -p, --include-pseudo-fs Include pseudo-filesystems (e.g. tmpfs) (default false) -r, --include-read-only Include read-only filesystems (default false) -f, --fail-on-error Fail and exit on errors getting file system usage (e.g. permission denied) (default false) -H, --human-readable print sizes in powers of 1024 (default false) --metrics Output metrics instead of human readable output --tags strings Comma separated list of additional metrics tags using key=value format. -h, --help help for check-disk-usage Use "check-disk-usage [command] --help" for more information about a command.
--include-fs-typeon the same check).
--include-pseudo-fsoption is false by default meaning that on Linux
--include-read-onlychecks for the
romount option on Linux and the
read-onlymount option on macOS and read-only volumes on Windows. By default
--fail-on-erroroption determines what occurs if the check encounters an
permission deniedfor a file system. If true, the check will
--human-readable(False by default) option determines if you prefer
Sensu Assets are the best way to make use of this plugin. If you're not
using an asset, please consider doing so! If you're using sensuctl 5.13 with
Sensu Backend 5.13 or later, you can use the following command to add the asset:
sensuctl asset add sensu/check-disk-usage
If you're using an earlier version of sensuctl, you can find the asset on the Bonsai Asset Index.
--- type: CheckConfig api_version: core/v2 metadata: name: check-disk-usage namespace: default spec: command: >- check-disk-usage --include-fs-type "xfs,ext4" --exclude-fs-path "/boot" --warning 90 --critical 95 subscriptions: - system runtime_assets: - sensu/check-disk-usage
--- type: CheckConfig api_version: core/v2 metadata: name: check-disk-usage namespace: default spec: command: >- check-disk-usage --include-fs-type "NTFS" --exclude-fs-path "C:,D:" --warning 90 --critical 95 subscriptions: - system runtime_assets: - sensu/check-disk-usage
The preferred way of installing and deploying this plugin is to use it as an
Asset. If you would like to compile and install the plugin from source or
contribute to it, download the latest version or create an executable from this
From the local path of the check-disk-usage repository:
For more information about contributing to this plugin, see Contributing.
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.×