(DI-1711) Appendix G: Alert definition

_{Alert definition}

Here you can create new alert definition.

_{Created alert}

This definition consists of:

• Alert type – describes the type of alert and determines the icon to be displayed if the alert occurs. Possible values are:
  • Success
  • Warning 
  • Issues 
  • Error 
• Period time – the frequency that specifies how often the alert is rechecked.
• Alert description – this description will be used as the label in outputs.

For every alert created, it is necessary to define associations to the KPI and to the Profile. This can be done in the Alert association category of this screen. The following fields should be filled:

• Monitoring profile – alert will be checked only for this profile under running Collector job.
• KPI name – alert will be checked only for the value of this KPI.
• Comparison operator – determines in which case a KPI value causes an alert to occur.

_{Comparison operator}

• Threshold – determines the limit value for a KPI. This alert will occur if the KPI exceeds its defined threshold of associated alert.
• Unit – determines the unit of measurement to be used, i.e. %, MB etc.
• Duration start – how long can a KPI value exceed the threshold (in grey area) before an alert will occur (starting delay for alert).
• Duration end – how long a KPI value has to be outside of the threshold area (in grey area) before an alert will be stopped (ending delay for alert).

_{Event association}

Each alert occurrence can be notified by email or by message in SAP Business Workplace. That can be done in the Alert notification category of this screen. The following fields should be filled:

• Monitoring profile.
• Recipient address – the email address or username from SAP system can be specified.
• Type of notification – determines the notification method. Possible values are:
  • E-mail – notification will be sent to the email specified in “Recipient address” field.
  • SAP Office message – notification will be sent to the SAP Business Workplace for user who is specified in “Recipient address” field.
  • Private distribution list – notification will be sent to all addresses defined in SAP Private Distribution List (transaction SO15 or button "Distribution list" in CanaryCode^TM toolbar).
  • Shared distribution list– notification will be sent to all addresses defined in SAP Private Distribution List (transaction SO15 or button "Distribution list" in CanaryCode^TM toolbar).
• BAdI ID – [optional] ID, which will be used for filtering of BAdI call. You can create your own BAdI for notification using BAdI implementation /DVD/MON_BADI_DEF_EVENT. Each BAdI implementation has to define the filter, which is also used for determining explicit call of the BAdI for processing of notification. Default BAdI implementation used for notification has initial BAdI ID.
• Alert notification – determines the period for sending of notifications. Possible values are:
  • At first occurrence – notify when alert occurs first time
  • At next occurrence – notify each occurrence of alert
  • At end of alert – notify when alert is completed 

 _{Alert notification} 

Alert definitions with threshold values and KPI associations are possible also directly from cockpit. KPI tree and chart provides functionality to set up thresholds from context menu. You can find more details here. But the user still have to set up "Alert notification" settings manually as in figure above.