salt.states.disk
Disk monitoring state
Monitor the state of disk resources.
The disk.status
function can be used to report that the used space of a filesystem is within the specified limits.
used_space: disk.status: - name: /dev/xda1 - maximum: 79% - minimum: 11%
It can be used with an onfail
requisite, for example, to take additional action in response to or in preparation for other states.
storage_threshold: disk.status: - name: /dev/xda1 - maximum: 97% clear_cache: cmd.run: - name: rm -r /var/cache/app - onfail: - disk: storage_threshold
To use kilobytes (KB) for minimum
and maximum
rather than percents, specify the absolute
flag:
used_space: disk.status: - name: /dev/xda1 - minimum: 1024 KB - maximum: 1048576 KB - absolute: True
-
Return the current disk usage stats for the named mount point
- name
-
Disk mount or directory for which to check used space
- maximum
-
The maximum disk utilization
- minimum
-
The minimum disk utilization
- absolute
-
By default, the utilization is measured in percentage. Set the absolute flag to use kilobytes.
New in version 2016.11.0.
- free
-
By default, minimum & maximum refer to the amount of used space. Set to True to evaluate the free space instead.
salt.states.disk.status(name, maximum=None, minimum=None, absolute=False, free=False)
© 2021 SaltStack.
Licensed under the Apache License, Version 2.0.
https://docs.saltproject.io/en/latest/ref/states/all/salt.states.disk.html