(DI-2305) Example: Percentage of free space on the root partition

Owned by SNP
May 03, 2023
3 min read

In this example, you might find brief instructions on how to create a custom KPI that monitors a percentage of the free space on root partition (based on (DI-2305) Collector for Disk/Folder Space Utilization).

For more information on how to create a custom KPI based on this type of collector, see the chapter Create a KPI through the Collectors with a Custom KPI.

 

Step 1: Define a custom KPI 

  1. Go to Settings > Monitoring settings (or transaction /DVD/MON_CUST).

  2. Find and select KPI FS_ROOT_FREE

  3. Copy this KPI into your custom KPI (F6) - for example, ZFS_ROOT_FREE

  4. Check all required fields for your custom KPI as displayed on the figure below (if needed, change the values according to your needs):

    1. KPI name: ZFS_ROOT_FREE

    2. Description: Free space monitoring on root partition

    3. KPI collector: /DVD/MON_CL_COL_SYS_FS

    4. Fill in all remaining fields for a custom KPI as displayed in the figure below. All the field descriptions can be found in the chapter Define a Custom KPI.

  5. Save the KPI definition (CTRL + S).

Step 2: Choose how data is collected into the custom KPI

  1. Select Settings > Collector settings (or the transaction /DVD/MON_COL)

  2. Select the collector /DVD/MON_CL_COL_SYS_FS.

  3. Double-click Inputs & rules.

  4. Select Edit next to the Input table /DVD/MON_SYS_FS1.

  5. Click Switch mode (Edit) (CTRL + F1) and then Create new records  (F6).

  6. Define new rule:

    1. Set system ID (optional) - when empty it applies to all systems

    2. Fill in the KPI name with your custom KPI name. In our example: ZFS_ROOT_FREE.

    3. Set Value result. to FREE_PERC.

    4. Fill Disc name to the root partition (or to any other path to be monitored).

7. Save the record (CTRL + S).

Step 3: Assign a Monitoring profile to the custom KPI 

Before you start to collect the created KPI, you must assign it to a Monitoring profile. In this example, we don't create a new Monitoring profile but assign the custom KPI to the default Monitoring profile DEF_5MIN.

  1. Go to the Settings > Monitoring settings (or transaction /DVD/MON_CUST).

  2. Double-click Profile definition. 

  3. Select and set your own Monitoring profile as described in the chapter Define a Monitoring Profile for a KPI. 

  4. Double-click Assigned KPIs.

  5. Click New Entries (F5).

  6. Fill in the KPI name ZFS_ROOT_FREE

  7. Save (CTRL+S).

The custom KPI ZFS_ROOT_FREE is now assigned to your custom Monitoring profile.

Step 4: Schedule the monitoring of a custom KPI 

The last step is to start the monitoring of the KPI for a specific system with its assigned custom Monitoring profile.

You may check in the Collector Jobs tab, if you created before a Collector job for the Monitoring profile of your custom KPI and if it is scheduled.
For information on how to schedule and start monitoring KPIs belonging to a Monitoring profile, see the chapter Schedule the Monitoring of KPIs.

If you created before a Collector job for your Monitoring profile of your custom KPI:

  1. Go to the Collector Jobs tab

  2. Find the Monitoring profile and click Stop and Start in the field Coll.job.
    In the fields Last status icon and Job last status is displayed when the Collector job run is completed.

If you didn't create a Collector job for the Monitoring profile, please see the example below on how to start the monitoring of the custom KPI.

  1. On the main screen, go to the Collector Jobs tab.

  2. Select Create collector job.

  3. Fill in the System ID on which you want to monitor the KPI. 

  4. Fill in your custom Monitoring profile

  5. Adjust the Period and Retention time according to your requirements.

  6. Click (Re)Start collector job.

When the Collector job was executed successfully, you may display the results of your custom KPI on the main screen. For further information on how to display a KPI, see the chapter Display KPIs.