(DI-1911) Example: Number of type conflicts when calling a FORM

This example shows how to create your own KPI, which collects information about how many times the error "Type conflict when calling a FORM" occurred. 

Define a custom KPI 

1. Go to the Settings > Monitoring settings (or transaction /DVD/MON_CUST).
2. Click New entries (F5)
3. Fill all required fields for custom KPI as display in the figure
   1. KPI name: "ZCUSTOM_PERFORM_CONFLICT_TYPE"
   2. KPI collector: "/DVD/MON_CL_COL_GET_DUMP"
   3. Fill in all required fields for a custom KPI as displayed in the figure. All fields descriptions can be found in (DI-1911) Define a Custom KPI.
      
      
4. Save the KPI (CTRL + S).

Choose how data is collected into the custom KPI through a collector job

1. Go to the Settings > Collector settings (or the transaction /DVD/MON_COL).
2. Select the collector /DVD/MON_CL_COL_GET_DUMP.
3. Double-click Inputs & rules.
   
4. Select Edit next to the Input table /DVD/MON_DUMP_I1.
   
   
5. Click Switch mode (Edit) (CTRL + F1) and then Create new records (F6).
6. In the next dialog define a new rule:
   1. Fill in KPI name with your custom KPI name ZCUSTOM_PERFORM_CONFLICT_TYPE.
   2. Set Rule nbr. to 1.
      
   3. Fill ABAP Runtime Error with the technical name of a dump: PERFORM_CONFLICT_TYPE.
   4. Set Active to 'X'.
   5. Set Into det. to 'X' (optional) - in the case you would like to collect details for this KPI.
   6. Fill in the Description.
      
      
7. Save the entries (CTRL + S).

At this point you have created a new custom KPI "ZCUSTOM_PERFORM_CONFLICT_TYPE", which collects information about how many times the error "Type conflict when calling a FORM" occurred. 

Create a Monitoring profile for the custom KPI 

Before you start to collect the created KPI, you must assign it to a Monitoring profile. To create a custom Monitoring profile and assign it to a custom KPI, follow these steps: 

1. Go to the Settings > Monitoring settings (or transaction /DVD/MON_CUST).
2. Double-click Profile definition. 
3. Click New Entries (F5)
4. Fill in the profile name ZCUSTOM
5. Double-click Assigned KPIs.
6. Click New Entries (F5).
7. Fill in the custom KPI name ZCUSTOM_PERFORM_CONFLICT_TYPE.
8. Save (CTRL+S).

The custom KPI "ZCUSTOM_PERFORM_CONFLICT_TYPE" is now assigned to the Monitoring profile "ZCUSTOM".

Schedule the monitoring of a custom KPI 

Custom KPI "ZCUSTOM_PERFORM_CONFLICT_TYPE" is now assigned to a valid Monitoring profile "ZCUSTOM". The last step is to execute the monitoring of KPIs for a specific system with the created Monitoring profile:

1. In the main screen, go the the Collector Jobs tab.
2. Select the Create collector job.
3. Fill the System ID on which you want to monitor the KPI.
   
4. Fill the Monitoring profile with a value ZCUSTOM.
5. Adjust the Period and Retention time according to your requirements
6. Click (Re)Start collector job

For information on how to schedule and start a Collector job, see (DI-1911) Schedule the Monitoring of KPIs.

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