(DI-1802) 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}

You can be notified about an alert occurrence by email or by message in SAP Business Workplace. Thais can be set in the Alert notification category of this screen. The following fields must 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 Insights toolbar).
  • Shared distribution list– notification will be sent to all addresses defined in SAP Private Distribution List (transaction SO15 or button "Distribution list" in Insights toolbar).
  • BAdI processing - recipient address will be treated as is defined in your BAdI implementation and the notification will be sent according to the implementation settings. When you select "BAdI processing" as a type of notification but BAdI ID is not specified, then the "Recipient address"will be used as the notification email. 
• 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 under the chapter Insights Monitoring Cockpit (section System and KPI Tree and Working Tabs). But you still have to set up "Alert notification" settings manually as in figure above. 

Examples of email alerts:

Insights can send in one email more alerts at a time. The subject line shows the number and the type of alerts which occurred on a particular system. Please see the figure below.

This figure shows an error type alert.

This figure shows a success type alert.

This figure shows a warning type alert.

This figure shows a issue type alert.

This figure shows an info type alert which is sent when an alert is closed.