(DI-2311) Collector for Disk/Folder Space Utilization
- SNP
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 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 |
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.