Processing Rules

This article describes the procedure required to set up processing rules, enabling you to process multiple signals that originate from various source systems.

Processing Rules allow you to specify conditions that trigger signals and the actions to take when those signals are triggered. Signal functions examine the attributes, capacity, and performance of resources. If the conditions defined for a signal are met, the actions that are specified for that signal are performed. For instance, define the condition as 'signal source equals OpsRamp' and specify the action as Priority P1. When the signal fulfills this condition, the defined action will be performed, ensuring that these signals are prioritized as P1.

One or more actions can be associated with a single rule. The association rules are executed when rule filters are satisfied based on the events that occur. A rule action can perform several action types, such as running an automation of the Resolution Intelligence Cloud process, suppressing a signal, or extracting several values from multiple signals.

Scope and Precedence of Rules

The users of Tenant, Organization, and Domain can create, disable, delete and edit the rules based on their required criteria. Once you configure the processing rules based on a required criteria, these rules are ordered in a precedence of Tenant --> Organization --> Domain. Also, each rule in tenant, or organization, or domain will be preceded over another based on the recent activity. However, you can always change the order of precedence just by holding and dropping button.

The configured rules are visible to the personnel who created those rules. Suppose the user of an Organization created a rule is accessible to that user only. Users of an Organization, and Domain are capable to push the rules to their associated tenants and sub-tenants or all tenants, but tenants could not push the rules to either Organization, or Domain.

The processing rules allow either the users of Tenant, or Organization, or Domain to draft and publish only one version of a rule at a time. This means that the users cannot create and publish multiple versions of the same rule at a time. Once a rule is published, users can disable or re-enable the same rule by clicking on the respective buttons in the settings menu. 

The routing rules created in functions are routed to the processing rules. You can view both routing and processing rules in the Processing Rules listing page.  If you want to edit the routing rule details, you must navigate to functions.  

Creating a Processing Rule

To create a new processing rule,

1. Click the gear icon  at the top (or) hover over the hamburger icon  at the top left corner.
2. In the bottom of the left menu, click Configurations.
3. In the left menu, under Signal Management, click Processing Rules.
4. In the Rules screen, click Add New Rule at the top right. 
   A rule creation window appears on your screen.
5. Give a Name for the Rule and add Description (Optional).
6. Select a label or add a new label to link to the processing rule.  
   Labels are keywords or tags that provide additional context, making it easier to search, filter, and categorize the processing rules.
   

7. Click +Add Condition or +Add Group to enable matching conditions.

• • Select an Attribute, Operator, and Value from the respective drop-down menu.
  • Click X to remove the condition.
  • Enable Negate next to the condition to negate the condition.
  • Check the box next to Match All to select all conditions that you have added.

5. Set the time period when the signal is active.

• • Always: irrespective of a time period
  • Only during a scheduled time: only on a specific date/time and/or recurrent time period. Default time is set in UTC.

6. Select one or more actions as mentioned in Actions allowed to be performed for the rule.

7. Select the Check to hide this rule check box to hide the rule. 

7. Click the Create Rule to create a new processing rule. 

Actions allowed

An action is performed based on the conditions that are evaluated and can possibly result in the modification of the signal object.

Action	Description
Priority	You can override the system set priority of incoming signal. For example, the system set priority is P1, you can override this with priorities from P0 to P4.
Extract	Use regular expressions to extract values from incoming signal fields and store them into new fields.
Signal Tags	Set tags as key-value pairs for signals.
Suppress	Suppress the incoming signal from the source system.
Discard	Discards the incoming signal. Set it to True or False.
Isolate	Set the signal to be isolated from being correlated.
Signal Buffering	Set the signals to wait before they get converted to situation. Set minimum and maximum buffer time to convert the signal to situation.

Viewing and filtering the processing rules

Use this procedure to view the list of processing rules created and filter the policies based on the defined search criteria. If there are many rules, you can use the search option to search for a processing rule you want. 

To view and filter processing rules:

1. Navigate to Configurations --> Processing Rules, under Signal Management.  The ActOn listing page appears. 
2. Click the Filter icon to view the following fields using which you can filter the ActOn policies:
   • Time Frame 
     • Always - Displays the rules that are always active. 
     • Once - Displays the processing rules that are active only for a certain period. 
     • Recurring - Displays the processing rules that are recurring.  
   • Actions
     • Signal Buffering - Displays the processing rules with this action.
     • Isolate - Displays the processing rules with the Isolate action.
     • Discard - Displays the processing rules with discard action. 
     • Suppress- Displays the processing rules with Suppress action. 
     • Signal Tag - Displays the processing rules with the signal tag.
     • Extract - Displays the processing rules with extract action.
     • Priority - Displays the processing rules that are set with priority. 
   • Labels - Can view the labels that are used in rule. Select the check box corresponding to the labels to filter by those. 
3. Click the Show Hidden Rules check box to view all the rules, including the hidden ones. Note that you can see this field at the domain level only. 
4. Click Apply to apply the selected filters. 
5. Review this processing rule information:

Field name	Field description
Order	Change the position of the processing rule in the list, using this button
Name	The name of the processing rule.
Matching Conditions	The conditions applied for the processing rule.
Scope	The hierarchy in which the processing rule was created. Possible values: Domain Organization Tenant
Actions Performed	The actions performed by this rule on the signal.
Applicable Time Frame	The time during which the rule is applicable.
Created Date	The date on which the rule was created.
Created By	The user who created this rule.
Updated Date	The date on which the rule was updated.
Updated By	The user who last updated the rule.

6. View the disabled rules in the Rules not in use, click on Enable to restore section. You can enable the disabled rule, using the Enable option from settings corresponding to the rule. 

You can perform the following actions on the listing page of Processing rules listing page, using the Settings icon corresponding to each processing rule:

• Disable the rule if it not required, using the Disable option. You can add the disabled rules later to the list, using the enable option that you see in the disabled list of processing rules. 
• Modify the processing rule details, using the Edit option.
• Change the position of processing rules, using the Move option. You can drag and drop the processing rules to the position you want using the reordering option, but you can reorder the rules only on the same page. 
• View the details of a processing rule, using the View option. 
• Delete a processing rule, using the Delete option. 

To import processing rules from the domain or organization, see Importing Processing Rules

To export selected or all rules to the JSON file, see Exporting Processing Rules

Importing Processing Rules

Resolution Intelligence Cloud enables you to import processing rules via an interactive user interface either from account hierarchy or from a JSON file. 

To import processing rules:

From the processing rules listing page, hover over the button and click any one of the following from the drop-down:

From Account Hierarchy:

1. Select the processing rules that you prefer to import.

     2. Click Next.

3. Click Proceed to Summary once you have added your required processing rules.

4. Select the following:

• • Append: adds the processing rules to the existing list without overriding.
  • Overwrite: replaces the existing processing rules.

5. Click Submit.

From JSON:

1. Select the JSON file that contains the processing rules to import into the platform. The Import Rules dialog appears. 
2. Select the check boxes corresponding to the processing rules you want to import. 
3. Click Proceed to Summary.
4. Select the following:
   
   • Append: adds the processing rules to the existing list without overriding.
   • Overwrite: replaces the existing processing rules in your account. 
5. Click Submit.

Exporting Processing Rules

You can export one or more processing rules that you defined in the Resolution Intelligence Cloud and share them with others in the organization or tenants.

To export processing rules:

From the processing rules listing page, hover over button and click any of the following from the drop-down.

• All: exports all processing rules that are available in Resolution Intelligence Cloud to a JSON file.
• Selectively: enables you to select the processing rules that you wish to export to a JSON file.