(DI-2305) Collector for Disk/Folder Space Utilization

The technical name of the Collector for Disk/Folder Space Utilization is /DVD/MON_CL_COL_SYS_FS and it is used to monitor disk or folder space utilization for Windows or Linux/Unix-based systems.

Collector supports the following functions to collect and calculate custom KPIs:

disk or folder used size in MB (function USED_SIZE)
disk free space in MB (function FREE_SIZE)
percentage of free space for provided disk path (function FREE_PERC)
number of files in provided disk or folder path counted recursively also for all subfolders (function FILE_COUNT)

Applying functions FREE_SIZE or FREE_PERC does not make sense for defined folder paths as it’s not possible to get a metric for the free space of the folder.

In this section:

Parameters

Parameter name	Default Value	Description
/DVD/MON_CL_COL_SYS_FS	'X'	If the parameter is set to the value 'X', statistics are collected regarding disks/folders via OS commands. If not, the data is collected via FM GET_FSYS_SINGLE.

Default KPIs delivered with this collector

There is only one default KPI delivered within this collector, but this KPI is not monitored by any monitoring profile. It serves as a template KPI based on which other custom KPIs can be created.

KPI name	Description	Unit	Collected on	Collected for	Server specification
FS_ROOT_FREE	Free space monitoring on the root partition	%	Remote system	Server	Only application server

Custom KPIs

The Collector for Disk/Folder Space Utilization enables you to create custom KPIs based on this collector. For more information on how to create a custom KPI, see the chapter Create a KPI through the Collectors with a Custom KPI.

You can find an example of how to create a custom KPI, which is based on this collector on the page (DI-2305) Example: Percentage of free space on the root partition.

Input table

This collector uses input table /DVD/MON_SYS_FS1.

The rules in this Input table define the custom paths to specific disk or folder names for monitoring and also the expected result value for the defined custom KPI. The input table provides the following fields:

Technical name	Column name	Description
SID	System ID	System ID for which this record applies (if System ID is empty, this record is applied for all systems)
KPI	KPI name	Name of the KPI that rule applies to
RES_VALUE	Requested result value	Defines the function of how the KPI is calculated.
DISC_NAME	Name of disk or partition	Path to the custom disk or folder name (to which is the selected function applied)
CHANGED_BY	Last changed by user [automatically filled]	User who last changed the specific record.
CHANGED_AT	Last changed time [automatically filled]	Time when the specific record was changed.
CREATED_BY	Created by user [automatically filled]	User who created the specific record
CREATED_AT	Created at the time [automatically filled]	Time when the specific record was created