salt.beacons.diskusage

Beacon to monitor disk usage.

depends

python-psutil

salt.beacons.diskusage.beacon(config)

Monitor the disk usage of the minion

Specify thresholds for each disk and only emit a beacon if any of them are exceeded.

beacons:
  diskusage:
    - /: 63%
    - /mnt/nfs: 50%

Windows drives must be quoted to avoid yaml syntax errors

beacons:
  diskusage:
    -  interval: 120
    - 'c:\\': 90%
    - 'd:\\': 50%

Regular expressions can be used as mount points.

beacons:
  diskusage:
    - '^\/(?!home).*$': 90%
    - '^[a-zA-Z]:\\$': 50%

The first one will match all mounted disks beginning with "/", except /home The second one will match disks from A:to Z:on a Windows system

Note that if a regular expression are evaluated after static mount points, which means that if a regular expression matches another defined mount point, it will override the previously defined threshold.

salt.beacons.diskusage.validate(config)

Validate the beacon configuration