(DI-2308) Example: Response Time for Custom-specified Disk Name

In this example, you might find brief instructions on how to create a custom KPI that monitors a response time for a custom-specified disk name.

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. Click New Entries (F5).

3. Fill in all required fields for your custom KPI as displayed in the figure below:

   1. KPI name: ZDISK_SDA_RESP_TIME.

   2. Description: Response time for disk sda.

   3. KPI collector: /DVD/MON_CL_COL_MEM_CPU_LAN.

   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.

      Open

      

4. 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_MEM_CPU_LAN.

3. Double-click Inputs & rules.

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

   Open

   

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

6. Define new rule:

   1. Fill in the KPI name with your custom KPI name. In our example: ZDISK_SDA_RESP_TIME.

   2. Set Value result. to RES_TIME.

   3. Fill in the Disk name with your custom disk to be monitored (in our example, we defined disk with the name sda).

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 do not create a new Monitoring profile but assign the custom KPI to the default Monitoring profile DEF_5MIN.

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

2. Double-click the 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 ZDISK_SDA_RESP_TIME.

7. Save (CTRL+S).

The custom KPI ZDISK_SDA_RESP_TIME 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 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 a Collector job for the 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 did not 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.