Collector for Disc/Folder Space Utilization

The technical name of the Collector for Disc/Folder Space Utilization is /DVD/MON_CL_COL_SYS_FS.

This collector is used to monitor disc or folder space utilization for Windows or Linux/Unix-based systems. It supports the following functions to collect and calculate custom KPIs:

  • TOTAL_SIZE: Total size of the disc or folder in MB

  • USED_SIZE: Used size of the disc or folder in MB

  • USED_PERC: Percentage of used space for provided disc path

  • FREE_SIZE: Free space on the disc in MB

  • FREE_PERC: Percentage of free space for the provided disc path

  • FILE_COUNT: Number of files in the provided disc or folder path counted recursively – also for all subfolders

NOTE Applying the functions FREE_SIZE or FREE_PERC does not make sense for defined folder paths because it is not possible to obtain a metric for the free space of the folder.

Default KPIs Delivered with This Collector

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

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 disc or folder space utilization enables you to create custom KPIs based on this collector. For more information about how to create a custom KPI, see the chapter Create a KPI Through Collectors with a Custom KPI.

You can find an example of how to create a custom KPI that is based on this collector on the page Example: Percentage of Free Space on the Root Partition.

Parameters

Parameter name Default Value Description
USE_DF_COMMAND 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.

Input Table

This collector uses the input table /DVD/MON_SYS_FS1.

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

Technical name

Column name 

Description

SID

System ID

System ID for which this record applies. If you leave the system ID empty, this record is applied for all systems.

KPI

KPI name

Name of the KPI to which the rule applies

RES_VALUE

Requested result value

Defines the function of how the KPI is calculated

DISC_NAME

Name of disc or partition

Path to the custom disc or folder name to which the selected function is 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

Example: Percentage of Free Space on the Root Partition