Updated on 2022-02-21 GMT+08:00

Configuring Masking Rules

Prerequisites

You have the following operation permissions: Set Masking Rules.

Context

  • After a rule is created successfully, if Alarm sources is set to All alarm sources or Event sources is set to All event sources in the rule, only the users whose managed objects are All Objects can modify or delete the rule. Other users can only modify or delete the rule in which Alarm sources is set to Custom alarm sources or Event sources is set to Custom event sources.
  • A rule is valid only to the alarms or events reported after the rule is enabled. Alarms meeting the conditions reported before the rule takes effect will not be masked, and alarms meeting the conditions reported after the rule takes effect will be displayed in the masked alarm list or discarded.
  • The masking rules are used to mask alarms based on the redefined name attributes. If both name redefinition rule and masking rule are set for an alarm, the name redefinition rule will take effect before the masking rule takes effect.
  • A maximum of 1000 masking rules can be created.
  • If all of the following conditions are met, the masking rule will mask all alarms or events, and alarms or events cannot be reported.
    • The masking rule is enabled.
    • All alarm or event sources are selected in the masking rule.
    • All alarm or event severities are selected in the masking rule.
    • Designated alarms or Designated events is not selected, and advanced conditions are not set in the masking rule.
    • The time filter condition is not set in the masking rule.
  • By default, the rules are sorted by the enabled and disabled states, and the rules in the same state are sorted by update time in descending order.

Procedure

  1. Choose Device Management > Alarms Management > Alarm Settings from the main menu.
  2. In the navigation pane, choose Masking Rules.
  3. On the Masking Rules page, click Create and select Alarm Masking Rules or Event Masking Rules.
  4. In the Basic Information area, set the rule name, description, and whether to enable the rule.
  5. In the Conditions area, set the alarms or events to be masked, and their severities and alarm or event sources. Set advanced conditions to filter the alarms or events for the rule to take effect based on parameters.

    • All alarm sources or All event sources is available only for users whose managed objects are All Objects.
    • In Alarm sources or Event sources, you can select All alarm sources or All event sources to mask the alarms or events that meet the conditions and are generated by the system and all MOs. Therefore, exercise caution when performing this operation.

  6. In the Time Filter area, set the time and period for the rule to take effect.
  7. In the Action area, set the handling policy for the masked alarms or events. Set Masked alarms to Discard or Displayed on Masked Alarms.

    • When an event masking rule is created, masked events can only be discarded.
    • If Discard is selected, the alarms will not be displayed. Therefore, exercise caution when performing this operation.

  8. In the Other area, set the priority for the rule.
  9. Click OK.

Related Tasks

  • Deleting a rule: You can select a redundant rule from the rule list and click Delete to reduce the rule maintenance workload.
  • Enabling/disabling a rule: You can select a rule that is not used temporarily from the rule list and click Disable. To use a disabled rule, select the rule and click Enable.
  • Migrating rules: You can click Export on the rule page of the source system to export rules. Then, click Import in the target system to import the rule file exported from the source system to the target system.
  • Backing up, collecting statistics on, and reviewing rules, and modifying rules in batches: You can click Export on the rule page to export rules and back up, review, and collect statistics on the rules. If you need to modify rules in batches, you can modify the rules in batches in the exported rule file. Then, click Import on the rule page to import the modified rule file.

Task Example

Scenario

O&M personnel plan to commission device A at 01:00 AM every Monday in April 20XX. Each commissioning is completed within two hours, during which services of device A are interrupted. Alarms generated during this period are predictable and do not need to be handled. You need to configure masking rules to mask these alarms.

Procedure

  1. On the Masking Rules page, click Create and select Alarm Masking Rules.
  2. In the Basic Information area, enter the rule name.
  3. In the Conditions area, select Custom alarm sources and add device A to the custom alarm sources.
  4. In the Time Filter area, set By period to 20XX-04-01 00:00:00 to 20XX-04-30 23:59:59, set By day to Mon, and set By time to 01:00 to 03:00.
  5. In the Action area, set Masked alarms to Displayed on Masked Alarms.
  6. Retain the default settings for other parameters.
  1. Click OK.

Result

The alarms generated by device A from 01:00 AM to 03:00 AM every Monday in April 20XX are not displayed on the Current Alarms, Alarm Logs, and Historical Alarms pages. You can view the masked alarms on the Masked Alarms page.

Parameter Description

The following uses the parameters for creating an alarm rule as an example, and they are similar to those for creating an event rule.

Table 1 Parameters for creating an alarm masking rule

Item

Parameter

Description

Conditions

Alarms

  • If you select Designated alarms, the rule takes effect only for the alarms you added.

    Alarm ID and Group Name: Unique identifiers of an alarm.

  • If you do not select Designated alarms, the rule takes effect for all alarms by default.

Alarm sources

  • All alarm sources: If this option is selected, the rule takes effect for the alarms generated by all alarm sources.
  • Custom alarm sources: If this option is selected, the rule takes effect only for the alarms of specified alarm sources.

Advanced conditions

Restrictions on items such as location information and alarm source type. For example, if you want to filter alarms by location information, select Location Info and contains and enter the alarm location information in the text box.

Time Filter

By period

Time range within which the rule will take effect. By default, Server time is selected.

By day

Days on which the rule takes effect in a week.

By time

Period for the rule to take effect in a day.

Action

Masked alarms

  • Displayed on the Masked Alarms page: The masked alarms will be displayed on the page opened by choosing Service Monitor > Alarms > Masked Alarms from the main menu.
  • Discard: Masked alarms will be deleted. If Discard is selected, the alarms will not be displayed. Therefore, exercise caution when performing this operation.

Other

Priority

Sets the priorities for alarm masking rules.

Change History

-

After a masking rule is created successfully, you can click a rule name and view the change history of the rule in the Change History area. This item is not displayed when you create a rule.