Show TOC

Procedure documentationCreating, Changing, and Deleting Alert Rules Locate this document in the navigation structure

 

Caution Caution

SAP NetWeaver Administrator for PI and all monitoring tools it includes are not supported for use in production scenarios. We recommend to use Runtime Workbench for PI monitoring in production scenarios. The information provided below is only for reference.

For more information, see SAP notes 1446507 and 1247043.

End of the caution.

You create an alert rule so that you can use alert categories to create alerts in certain situations.

Prerequisites

You have started the SAP NetWeaver Administrator for PI and have chosen Alert Rules.

Procedure

Creating an Alert Rule

To create an alert rule in which you use a defined alert category, proceed as follows:

  1. To create a rule to produce alerts that are assigned to a concrete message, first display the rules that are bound to messages and then choose   Add   Rule Bound to Message  .

  2. To create a rule to produce alerts that are not assigned to a message - but which are to be traced to errors that occurred before a message was sent - first display the rules that are independent from messages and then choose   Add   Message-Independent Rule  .

  3. Give the rule a name (Description) and specify the alert category you want to use.

  4. If you want to create a new alert category, choose the corresponding link.

    More information: Creating Alert Categories.

  5. If you want the rule to be activated automatically and to be displayed as active when you add it, select the Active Rule check box.

  6. If you do not want further alerts to be generated once the rule has been met until the first alert has been confirmed, select the Suppress Multiple Alerts of This Rule checkbox.

    Every alert is classified according to error category and code. On the AS Java side, the system checks how much time is elapsed since the last alert for this combination. The system raises an alert only if this time is greater than a configurable time interval. The time interval is specified in the alerting.suppressInterval parameter of AF Core Services and its default value is 50000 (in milliseconds). For more information about changing service parameters, see Java Service Properties for the Adapter Framework.

    When the condition for raising an alert is not complete, the system writes the following entry into the trace: com.sap.aii.af.service.alerting.AlertingException: An alert with suppress information: [...details...] was suppressed!

  7. For rules that are bound to messages, specify whether a concrete message (with message ID) has to be available (default setting).

  8. If required, restrict the errors further to:

    • Errors reported from the Integration Engine (with error category or error code)

    • Errors reported from the Adapter Engine (with adapter type)

      Note Note

      Only errors reported from the Adapter Engine are taken into consideration for message-independent rules.

      End of the note.

  9. If necessary, specify conditions for the sender or receiver, or both.

    Note Note

    With message-independent rules you cannot enter any further details about the sender or receiver.

    End of the note.

  10. Save your rule to add it to the list of alert rules.

    Once you have created a rule, it is automatically displayed in the list of alert rules.

Changing an Alert Rule

You can change and delete existing rules. To change rules, proceed as follows:

  1. Select the rule you want to change in the list of displayed alert rules. The rule details are displayed.

  2. Make the required changes.

  3. Save your changes.

Deleting an Alert Rule

You can change and delete existing rules.

To delete rules, select the rule in the list of displayed alert rules and choose Delete.