Managing Alarm Trigger Rules


An alarm trigger rule is the alarm trigger condition configured for the KPI or measurement point of the asset. When the data value or status of the KPI or measurement point meets the configured condition, the alarm will be triggered.

Prerequisites


Before starting, make sure you have the following ready:

  • Ensure that the current account has been assigned the required asset permissions and a menu group, including Alarm Rule. If not assigned, contact the OU administrator.

  • To configure alarm rules of measurement points, ensure assets are connected and the corresponding models are linked.

  • To configure alarm rules of KPIs, ensure that the template bound to the current OU has acquired the KPIs required for Alarm Management.

Creating an Alarm Trigger Rule


  1. Select Alarm Rule in the left navigation bar to access the Alarm Rule page.

  2. Select New Rule, then on the New Rule page, enter the following information in Basic Information:

    • Rule Name: Enter the name of the alarm rule. You can enter up to 64 characters.

    • Rule ID: Enter unique numbers to distinguish the alarm rule, which cannot be modified after creation. Numbers, letters, periods (.), underscores (_), and dashes (-) are supported, and up to 64 characters can be entered.

    • Rule Description: Enter a description for the alarm rule. You can enter up to 100 characters.

    • Enable Alarm Rule: Enabled by default. If disabled, the alarm trigger rule will not take effect.

    • Rule Effective Period: Select Any Time (default) or Specified Period for the alarm rule. An alarm rule with a specified period triggers new alarms only during its effective period. No new alarm record is created outside the effective period. For example, you can configure an alarm rule for office-building air-conditioning power to take effect only during working hours on weekdays.

    Note

    • The rule effective period is evaluated in the time zone of the asset that triggers the alarm.

    • During the effective period, an active alarm recovers normally when the measurement point value meets the recovery condition. Outside the effective period, if an active alarm exists, it recovers when any triggering measurement point reports a new value.

    • Alarm rules with Time Series enabled support only Any Time. When you select Specified Period, the system turns off and disables Time Series. When a rule that uses a time series operator is switched to Specified Period, the system replaces the operator with the first non-time-series operator. If an expression contains a time series function, the system prompts you to delete it; after it is deleted, the Time Series toggle is turned off.

    • Tags: Add tags for the alarm rule. Tag keys are fixed, and tag values can be entered as any field.


    ../../_images/rule_step1_new.png


  3. In Condition Settings, enter the following information:

    • Source: Select the source of the alarm, supporting Metric, Measurement Point, and Device Status.

    • Condition: Configure the alarm trigger condition for assets. The alarm condition for each source is as follows:

      • Measurement Point Alarm Condition: Set a condition for the measurement point itself, or set a condition based on the numerical relationship between the measurement point and an attribute or another measurement point. For more information, see Measurement Point Alarm Condition.

      • Metric Alarm Condition: Set a condition for the metric data associated with a model. For more information, see Metric Alarm Condition.

      • Device Status Alarm Condition: Select Device to trigger an alarm when any asset status in the effective scope is offline. Select a Model to trigger an alarm when any asset of that model in the effective scope is offline.

  4. In Valid Scope, set the scope where the alarm rule takes effect. You can specify the scope in the following ways:

    • When setting conditions, you have already specified the main asset type. By default, the effective scope includes all assets of this type. Any device meeting the conditions for this asset type in the current OU will trigger an alarm.

      ../../_images/point_default_scope.png

    • Click the Switch Asset Tree Figure: Tree button to select an asset tree. Expand the tree and select the nodes you need, so that the scope covers only the assets of this type under the selected nodes.

      ../../_images/point_tree_scope.png

    • After the selection is done, Valid Scope shows the selected asset tree. To adjust the scope, expand the tree again and change the selected nodes.

      ../../_images/point_asset_scope.png

  5. Enter the following information in Alarm Settings:

    • Alarm Content: Enter the content of the alarm.

    • Alarm Group: Select a group to which the alarm severities and alarm types belong.

    • Alarm Severity: Select an alarm severity of the current group type according to business needs and actual scenarios. For example, the optimal operating temperature of a device is 80 degrees. If the temperature of the device exceeds 100 degrees, the alarm severity can be set as Info; when the temperature of the device exceeds 150 degrees, the alarm severity can be set as Warning; and when the temperature of the device exceeds 200 degrees, the alarm severity can be set as Fault.

    • Alarm Type: Select an alarm type of the current group type according to business needs and actual scenarios.

    • Possible Reasons: Enter the possible reasons for triggering the alarm rule.

    • O&M Recommendations: Enter the O&M recommendations for the triggered alarm.

    Note

    When an alarm is triggered, you can view possible reasons and O&M recommendations of this alarm in the details tab (including Active Alarm and Alarm Log).

    • Trigger Delay: Set a time delay for triggering the alarm. For example, if you set the delayed time to 5 seconds and the alarm trigger condition is set as device voltage > device rated voltage, the alarm rule will be triggered when the device voltage is greater than the device rated voltage for 5 seconds continuously.

    • Discrete Alarms: Enable discrete alarms when an alarm is triggered. A discrete alarm generates an alarm record and immediately ends monitoring for that event. When the trigger condition is met again, a new alarm record is generated. For more information, see Discrete Alarms.


    ../../_images/rule_step3.png


  6. Click Save.


After creating an alarm trigger rule, you can view the corresponding entry in the list on the Alarm Rule page.

Note

If you need to add more sites, devices, or component instances, contact the device manager.

Editing an Alarm Trigger Rule


  1. Select Alarm Rule in the left navigation bar to access the Alarm Rule page.

  2. Click Edit Figure: Edit in the corresponding alarm rule row to edit the configuration information excluding Rule No..

  3. Click Save.

Note

If a visualization group is configured for the corresponding asset type after an alarm rule is created, the existing rule continues to take effect. However, if a measurement point, attribute, or metric selected in the rule is not included in the group, you cannot view the selected item when editing the rule.

Deleting an Alarm Trigger Rule


  1. Select Alarm Rule in the left navigation bar to access the Alarm Rule page.

  2. Click Delete delete_rule_icon_white in the corresponding alarm rule row to delete an alarm rule.

    If you need to delete multiple alarm rules at the same time, click Batch Delete at the top of the page after checking the alarm rules. The alarm rules cannot be restored once deleted.

Enabling/Disabling an Alarm Trigger Rule


  1. Select Alarm Rule in the left navigation bar to access the Alarm Rule page.

  2. Turn off the Enabled toggle in the target alarm trigger rule row to disable the rule, and turn the toggle back on to enable it again.

    Note

    If a disabled alarm rule has active alarms and the triggering measurement points of those alarms report new values, the active alarms recover.

Exporting Alarm Trigger Rules


  1. Select Alarm Rule in the left navigation bar to access the Alarm Rule page.

  2. Click Batch Export at the top of the page, select the rules you need to export, and export a JSON file.

Importing Alarm Trigger Rules


  1. Select Alarm Rule in the left navigation bar to access the Alarm Rule page.

  2. Click Batch Import at the top of the page and upload a JSON file or Excel file.