4.15 FileSystemSpace

Use this Knowledge Script to monitor the used space and free space on mounted file systems and optionally, check for incremental increases in used space beyond the specified threshold.

For example, you can configure this Knowledge Script to Create a new event for incremental increases and set the Threshold for incremental increases to 5% to create an event when used space exceeds 80%, and create a new event when used space exceeds 85%, 90%, and 95%.

When checking for incremental increases, a single event is created if the specified threshold is met; event collapsing is not applicable. If you want to monitor incremental increases in used space, do NOT enable the event option on the Advanced tab to Generate a new event when original event condition no longer exists. If you enable this option, the Knowledge Script incorrectly raises an event.

If you want to prevent monitoring of some types of file systems, use the DynamicFileSystemSpace Knowledge Script.

4.15.1 Resource Objects

Any logical disk or disks.

4.15.2 Default Schedule

The default interval for this script is Every hour.

4.15.3 Setting Parameter Values

Set the following parameters as needed:

Description

How to Set It

Event Notification

Raise event if threshold exceeded?

Select Yes to raise an event if the amount of file system space used or free exceeds the capacity threshold you specify. The default is Yes.

Threshold -- Maximum used space

Set the threshold for the maximum amount of used space (total capacity). The default is 80.

NOTE:If you use this parameter, also select the units you want to use.

Threshold -- Minimum free space

Set a threshold for the minimum amount of free space available (total capacity) for use. The default is -1, meaning no minimum.

NOTE:If you use this parameter, also select the units you want to use.

Units

Select the unit of measure you want to use to determine the threshold for the used space and free space parameters. Available units are percentage, kilobytes, and megabytes. The default is %.

Incremental Event Notification

Raise new event for incremental increases?

Select Yes to continue to raise events if the amount of file system space used exceeds the capacity threshold you specify and continues to increase since the previous event. The default is unselected.

Threshold -- Incremental increases

Set the amount that must be exceeded before another event is raised while the initial threshold remains exceeded. The default is 5.

Data Collection

Collect data for used and available space?

Select Yes to collect data for charts, graphs, and reports. When selected, this script returns the amount of used file system space, the amount of available file system space, the used space, and free space. The default is unselected.

Event severity when used space exceeds threshold

Specify the event severity level, from 1 through 40, to indicate the importance of the event. The default is 5.

Event severity for internal failure

Set the event severity level, from 1 to 40, to indicate the importance of an event in which this job experienced an internal error. The default is 5.

Enable debugging? (y/n)

Select Yes to enable debugging. The default is unselected.