help | logout
diskfree

diskfree

Name

diskfree -- Monitors free disk space on partitions and disk drives.

Description

The diskfree module is used to monitor disk usage on local drives and parititions, as well as drives mounted on the computer. Diskfree will report a percentage of space being used. Configuration can be used to monitor specific drives, and on most platforms can monitor all drives or drives of a specific type (such as ext2 or reiserfs).

Configuration

Restricted access to drive information on Windows platforms limits the type of broad configuration available on the other systems. In Windows, specific drives must be listed, either through use of the RSPD configuration window (see Chapter 2 for more details), or by editting rspd.conf. If rspd.conf is used, drives are listed using the "checkDrive" variable. Any other variables are ignored. Here is an example of configuration on a Windows machine.

# Example windows configuration
config
{
	checkDrive = c:
	checkDrive = e:
}
		

On non-Windows platforms, more extensive configuration is allowed. Three levels of checks are possible: all drives, drives of a certain type, and finally specific drives. Diskfree will go through these levels in order. It will first check if all drives should be checked through the "checkAll" variable (default is off). Depending on this value, types of drives can be added with "checkType" or ignored with "ignoreType". Finally specific drives are then added in with "checkDrive".

Here are some examples. In this first one, diskfree is told to check all mounted ext3 partitions, as well as "/mnt/beta", an nfs parition:

# Non-windows configuration example 1
config
{
	checkType = ext3
	checkDrive = /mnt/beta
}
		

In this next example, we tell diskfree to check all drives except for nfs partitions, which should be ignored.

# Non-windows configuration example 2
config
{
	checkAll = 1
	ignoreType = nfs
}
		

Finally, we show how all levels are used. We specify that all drives are checked, but to ignore reiserfs paritions. However by adding /var/log, which is reiserfs, this drive will be checked.

# Non-windows configuration example 2
config
{
	# We will check all drives except for
	# reiserfs partitions other than /var/log.
	checkAll = 1
	ignoreType = reiserfs
	checkDrive = /var/log
}
		

Thresholds

Diskfree may check drive usage against set thresholds. Thresholds can be checked against any drive name, or the name "any" which will set the threshold true if any checked drive reports true. Any of the basic logical operators are allowed (==, !=, <, >, <=, >=). Here are some examples:

# Example thresholds for diskfree
thresh1.threshold = DiskFree./ > 95%
thresh2.threshold = DiskFree./var/log <= 10%
thresh3.threshold = DiskFree.any > 98%
		

History Data

The diskfree module will save each drive's usage. This data, using the RSP History Viewer or RSP Web tools, can be used to monitor changes in disk usage over time.