14.14 CurrentDiskSpaceUsage

Use this Knowledge Script to generate a report detailing the used space on logical disks.

This report uses data collected by any Knowledge Script that monitors the available MB or the percentage of used space on a logical disk, such as NT_DiskSpace or UNIX_FileSystemSpace. Ensure you archive data detail when running the Knowledge Scripts to collect data. You must disable the Do not archive data detail option in the Advanced tab of the Knowledge Script properties dialog box to allow automatic data archiving.

NOTE:In the Filter Settings parameters, if you set the Filter column parameter to Drive and the Filter operator parameter to either Greater than or Less than, the script will not run but will raise an event indicating you made an invalid configuration of the script. For example, a drive can be equal to/not equal to C:, but not greater than/less than C:.

14.14.1 Resource Object

Report agent

14.14.2 Default Schedule

The default schedule is Run once.

14.14.3 Setting Parameter Values

Set the following parameters as needed:

Parameter

How To Set It

Data source

Select computer(s)

Filter the data for your report by computer.

Select time range

Filter the data for your report by a specific or sliding time range. The default is Sliding.

Select type

Select the method by which report content is ordered. Possible values are:

  • By computer

  • By drive

  • By total space

  • By space used

  • By percent used

  • By space free

  • By percent free

For example, if you select By computer, then data is ordered by computer name. If you select By drive, data is ordered by drive letter.

Sort order

Select whether values are displayed in an ascending or descending order.

Filter Settings

Filter column

Use this parameter to set the first variable of the filtering equation.

Use this parameter in conjunction with the Select type parameter. Make sure the two parameters have comparable values (for example, if Select type is set to By drive, set this parameter to Drive).

If Select type is set to By computer, set this parameter to <None>.

Possible values are:

  • <None>

  • Drive

  • Total space

  • Space used

  • Percent used

  • Space free

  • Percent free

Filter operator

Select an operator for the filtering equation. Possible values are:

  • Greater than

  • Less than

  • Equal to

  • Not equal to

Filter value

Specify a value for the second variable of the filtering equation.

For example, if the first variable is Drive, and the operator is Equal to, set this parameter to C: to return data for all C: drives.

Report settings

Disk space units

Select whether you would like the values in the report expressed in MB or GB.

Include parameter help card?

Select Yes to include a table in the report that lists parameter settings for the report script.

The default is Yes.

Select output folder

Set parameters for the output folder.

Add job ID to output folder name?

Select Yes to append the job ID to the name of the output folder.

A job ID allows you to correlate a specific instance of a Report Script with the corresponding report.

The default is unselected.

Select properties

Set miscellaneous report properties as desired.

Add time stamp to title?

Select Yes to append a time stamp to the title of the report, making each title unique. The time stamp is made up of the date and time the report was generated.

A time stamp allows you to run consecutive iterations of the same report without overwriting previous output.

The default is Yes.

Event notification

Event for report success?

Select Yes to raise an event when the report is successfully generated. The default is Yes.

Severity level for report success

Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 35 (magenta level indicator).

Severity level for report with no data

Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 25 (blue level indicator).

Severity level for report failure.

Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 5 (red level indicator).