# salt.beacons.diskusage

Beacon to monitor disk usage.

Added in version 2015.5.0.

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