...
Create an Alarm Detection configuration by clicking the New Configuration button in the upper left part of the Desktop window, and then selecting Alarm Detection from the menu.
The Alarm Detection
Select the Workflow Alarm Value Names option to define a variable you can use in the APL code, see the /wiki/spaces/MD82/pages/3781270.
Field/Option | Description |
|---|---|
Alarm Detection Enabled | Select this checkbox to turn on alarm detection. |
Description | Enter a statement that describes the Alarm Detection that you are defining. |
Severity | Select the importance priority of the alarm from the drop-down list. The available severities are:
|
Adding an Alarm Condition
At the bottom of the Alarm Detection configuration, click the Add button. The Add Alarm Condition dialog box opens.
...
Select a condition in the Alarm Condition drop-down list.
| Anchor | ||||
|---|---|---|---|---|
|
The Alarm conditions enable you to define specific situations or events for which you want the system to produce an alarm. You configure a condition to produce an alarm whenever a certain behavior occurs, within specific limits.
| Note | |
|---|---|
| title | Note!
|
The Alarm Conditions that you can choose from are:
Host Statistic Value
Pico Instance Statistic Value
System Event
Unreachable Execution Context
Workflow Alarm Value
Workflow Execution Time
Workflow Group Execution Time
Workflow Throughput
System Event
The System Event condition enables you to setup an Alarm Detection for the various Event types.
The System Event condition
Host Statistic Value
The Host Statistic Value condition enables you to set up an Alarm Detection for the various statistic values by the host.
...
Item | Description |
|---|---|
Event Properties | |
Host | Select a host for applying the alarm condition. |
Statistic Value | The statistical criteria on the host include:
|
Limits | Specify the condition for the alarm to be triggered. The options are Exceeds or Falls Below the selected statistic value. |
Pico Instance Statistic Value
The Pico Instance Statistic Value condition enables you to set up an Alarm Detection for the various statistic values by Pico instances.
...
Item | Description |
|---|---|
Event Properties | |
Pico Instance | Select a Pico instance for configuring the alarm, it can be Platform, EC |
Statistic Value | The statistical criteria on the Pico instance include:
|
Limits | Specify the condition for the alarm to be triggered. The options are Exceeds or Falls Below the selected statistic value. |
System Event
The System Event condition enables you to set up an Alarm Detection for the various Event types.
Item | Description |
|---|---|
Event Properties | |
Type | Select an event-related reason for an alarm to be invoked. For a detailed description of every event type, see Event Types. |
Filter | Use this table to define a filter of criteria for the alarm messages that you are interested in. To define an entry, double-click on the row. The Edit Match Value dialog box opens. Click the Add button to add a value. |
Limits | Specify the condition for the alarm to be triggered. The options are based on the number and frequency of occurrence of the event: Occurred Once, Occurred More Than, Occurred Less Than. |
In During Last, specify the time frame during which the Limits value should be compared. If a match is detected, an alarm is invoked. |
| Info |
|---|
...
Example - Configuring a System Event condition
|
...
|
...
The alarm will be triggered by every |
...
fourth occurrence of a "Workflow State Event" during the last 24 hours. |
Unreachable Execution Context
The Unreachable Execution Context condition enables you to set up an Alarm Detection based on a selected Pico Instance, except the platform.
...
The Unreachable Execution Context condition
Item | Description |
|---|---|
Event Properties | |
Pico Instance | Select a Pico instance for configuring the alarm, it can be Platform, EC |
Unreachable due to normal shutdown | Unchecked this checkbox to ignore the pico unreachable due to shutdown by purpose. |
Limits | Enable the "During Last" checkbox to further focus on the X duration of Minutes/ Hour. |
Workflow Alarm Value
The Workflow Alarm Value condition is a customizable alarm condition. It enables you to have the Alarm Detection watch over a variable that you create and assign through the APL code. To apply the Workflow Alarm Condition use the following guidelines:
Create a variable.
Assign the variable with a value.
...
Set up the Workflow Alarm Value condition.
To create a variable name:
From the Edit menu in the Alarm Detection configuration menu, select Workflow Alarm Value Names. The Workflow Alarm Value dialog box opens.
Click the Add button and enter a variable name, e g CountBillingFiles.
Click OK and then close the Workflow Alarm Value dialog box.
To define the Value field:
In the APL code, include the command dispatchAlarmValue. For example:
| Code Block | ||||
|---|---|---|---|---|
| ||||
consume {
dispatchAlarmValue
("CountBillingFiles",1);
udrRoute(input);
} |
To configure the Workflow Alarm Value Condition:
At the bottom of the Alarm Detection configuration, click Add;
...
the Add Alarm Condition dialog box opens.
From
...
the Alarm Condition drop-down list select Workflow Alarm Value.
From
...
the Value
...
drop-down list, select the name of the variable that you created.
Click Browse... to select the Workflow that the Alarm Detection should guard.
Configure the Limits according to the description of The Workflow Alarm Value and click OK.
The Workflow Alarm Value configuration
Item | Description |
|---|---|
Workflow Properties | |
Value | Select an alarm value from the drop-down list. |
Workflow | Click Browse... to enter the workflow instance(s) that you want to apply the alarm to. |
Limits | Summation: Select this check box to add up the Note: Selecting Summation means that the During Last entry refers to the |
period during which a sum is added up. Once the set period has ended, that sum is compared with the limit value. For All Workflows: Select this check box to add up the values (see Summation above) of all the workflows that the alarm supervises. Alarm Detector compares this total value with the alarm limit (exceeds or falls below), and generates an alarm message accordingly. Note: This check box can only be selected when Workflow is set to Any. For further information about Limits see the section above, Host Statistic Value. |
Workflow Execution Time
The Workflow Execution Time condition enables you to generate an alarm whenever the execution time of a particular, or all workflows, exceed exceeds or fall falls below the time limit that you specify.
The Workflow Execution Time configuration
Item | Description |
|---|---|
Workflow | The default workflow value is Any. Use this value when you want to apply the condition to all the Workflows. Otherwise, click Browse to select a Workflow that you apply the condition to. |
| Info |
|---|
...
Example - Configuring a Workflow Execution Time condition
A telecom provider wants the system to identify a workflow that has recently run out of input, and to generate an alarm that warns about a processing time that is too short.
|
...
|
...
An alarm is generated whenever an active workflow seems to process data too fast (in less than 2 seconds). |
Workflow Group Execution Time
The Workflow Group Execution Time alarm condition enables you to generate an alarm whenever the execution time of a workflow group exceeds or falls below the time limit that you specify.
The Workflow Group Execution Time configuration
Item | Description |
|---|---|
Workflow Group | Click Browse... to enter the address of the workflow group to which you want to apply the alarm. |
| Info |
|---|
...
Example - Configuring a Workflow Group Execution Time condition
You want the system to generate an alarm if a billing workflow group has been active longer than 3 hours.
|
...
|
...
The alarm will be triggered if the workflow group has been active longer than 3 hours. |
Workflow Throughput
The Workflow Throughput alarm condition enables you to create an alarm if the volume-per-time processing rate of a particular workflow exceeds, or falls below, the throughput limit that you specify.
The Workflow Throughput configuration
Item | Description |
|---|---|
Workflow | Select a workflow with the throughput value, and the processing speed, that you want to supervise. For further information about the throughput value calculation, see Throughput Calculation in 3.1.8 Workflow Properties. An alarm is generated if the throughput value is not within the condition limits. |
Limits | For information about Limits see the section above, Host Statistic Value. |
| Info |
|---|
...
Example - Configuring a Workflow Throughput condition
You want the system to warn you |
...
about the detection of a decreased processing rate.
|
...
|
...
The alarm will be triggered by every occurrence of a workflow slowing down its processing rate to a throughput that is lower than 50000 units per second. |
| Scroll pagebreak |
|---|