disk
Use case
Alert when a filesystem is filling up. For “is something mounted there at all” without a capacity check, see mount.
Configuration
Both required, no default for either:
| Field | Type | Meaning |
|---|---|---|
path |
string | filesystem path to check (e.g. / or /data; on Windows, a drive like C:\) |
alert |
float | percent; alert (critical) above this - no “never alert” sentinel here, since it’s required |
Output
In this exact order:
| Item | Type | Meaning |
|---|---|---|
disk |
string | the configured path (tag) |
disk_total |
int (bytes) | total space (datapoint) |
disk_used |
int (bytes) | used space (datapoint) |
disk_free |
int (bytes) | free space (datapoint) |
disk_percent |
float (%) | used, percent (datapoint) |
Example
checks:
- module: disk
name: disk_root
conf:
path: /
alert: 80
severity_max: warning