(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

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

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

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

Make sure you add the full disk name on the Unix system. To check available disk names on your Unix system execute the df OS command and check the Filesystem output column.