Creating, editing, and deleting rule-based groups

 

Rule-based groups are groups that are created based on specific conditions or criteria that you specify. Only those devices and monitors that match the conditions you specify are added to the group.

To create a rule-based group

  1. Go to Configuration > Groups and click action menuconsole_actionMenu2.png next to Group Configuration.

    Note

    The Create Rule Based Group icon is visible only on the Manual Groups tab. You cannot perform add, update, or delete operations on synchronized groups because these groups are automatically synchronized from Infrastructure Management.

  2. Click Create Rule-Based Group.
    Because you are creating a rule-based group, the Type field displays Rule-Based Group. Specify information as per the following table:

    Note

     The values that you enter for the properties are not case-sensitive. 

    Field name

    Description

    Group Name

    A name for the group you are creating.

    Note

    The group name must be within 60 characters. 

    Description

    A brief description of what the group was created for.

    Parent Groups

    Select the parent group if you want the newly created group to be a child of this parent group. You can choose more than one parent group.

    Child Groups

    Select the child group that must belong to the newly created group. You can select either a manual or automatically synchronized group as a child group. You can select more than one group as a child group.

    Note

    You can select a child group from a list of manual and automatically synchronized groups. The automatically synchronized group names are displayed along with their associated Infrastructure Management server names enclosed in the parentheses as shown in the following screenshot.

    sync_as_child_grp.png

  3. Click the add_condition.png to add one or more rules to select devices. You can set multiple conditions to select devices as shown in the following example:

    The values that you enter for the properties are not case-sensitive. 

    device_selection_criteria_113.png

     

    Step-by-step instructions to select devices
    1. Select one of the following properties:
      • Device Name
      • Device DNS Name
      • Device IP Address
      • Meta Tag
        Note: The Meta Tag is supported only with:
        • TrueSight Presentation Server version 11.3.03 and later
        • TrueSight Infrastructure Management server version 11.3.03 and later
        • PATROL for Microsoft Azure version 2.1.10 and later
        • PATROL for Amazon Web Services 2.1.10 and later
      • Tenant Name
    2. Select an operator to create the condition. The available operators depend on the property that you select.
    3. Specify a value for the selected property.
      Notes:
      1. The Meta Tag is specified as the key-value pair. The operator selected is applicable to the key and value specified. For example, if the condition is Meta Tag Where env equals production, then it checks if the env key is set to production.
      2. The = and " characters are not supported in the key and value fields. 
    4. (Optional) To add more than one condition, click the add_condition.png, and perform the earlier steps.
    5. (Optional) To group the conditions, use parenthesis and boolean operator from their corresponding lists:
       
      • (
      • ((
      • (((
      • )
      • ))
      • )))
      • AND
      • OR
    6. (Optional) To remove any existing condition, click the remove_condition.png. 
    7. To view the list of devices that are selected based on the specified criteria, click Preview. 
      Note: The Preview option is enabled only after you specify values for the selected conditions.
    8. Click Save.

  4. Click the add_condition.png to add one or more rules to select monitor instances. You can set multiple conditions to select monitor instances as shown in the following diagram:
    Note: The values that you enter for the properties are not case-sensitive.

    monitor_selection_criteria.png

    Step-by-step instructions to select monitor instances
    1. Select one of the following properties:
      • Monitor Name
      • Monitor Type
      • Device Name
      • Device DNS Name
      • Device IP Address
      • Meta Tag
        Note: The Meta Tag is supported only with:
        • TrueSight Presentation Server version 11.3.03 and later
        • TrueSight Infrastructure Management server version 11.3.03 and later
        • PATROL for Microsoft Azure version 2.1.10 and later
        • PATROL for Amazon Web Services 2.1.10 and later
      • Tenant Name
    2. Select an operator to create the condition. The available operators depend on the property that you select.
    3. Specify a value for the selected property.
      Notes:
      1. The Meta Tag is specified as the key-value pair. The operator selected is applicable to the key and value specified. For example, if the condition is Meta Tag Where env equals production, then it checks if the env key is set to production.
      2. The = and " characters are not supported in the key and value fields. 
    4. (Optional) To add more than one condition, click add_condition.png, and perform the earlier steps.
    5. (Optional) To group the conditions, use parenthesis and boolean operator from their corresponding lists:
      • (
      • ((
      • (((
      • )
      • ))
      • )))
      • AND
      • OR
    6. (Optional) To remove any existing condition, click remove_condition.png. 
    7. To view the list of monitors that are selected based on the specified criteria, click Preview. 
      Note: The Preview option is enabled only after you specify values for the selected conditions.
    8. Click Save.

    When you upgrade rule-based groups

    The new rule configurations in TrueSight Infrastructure Management version 10.7 or later versions appropriately formats all the existing rules used in rule-based groups, after you upgrade to TrueSight Infrastructure Management version 10.7 or later versions from any of its earlier versions.

    Rule configured to create a group in the TrueSight Infrastructure Management version earlier to 10.7
    rule_based_group_sample1.png

    Reformatted rule in TrueSight Infrastructure Management version 10.7 or later versionsnew_rule_based_group.png

  5. (Optional) Select Mark the instances and devices for deletion from the system.

    When selecting this option is useful?

    Select this option only if you have to delete the instances and devices after a short period of time. By default, it is set to 48 hours in the <property_name> property. You can configure this <property_name> property using the tssh set property command.

    Note: Selecting this option removes the instances and devices along with the historical data from the system as per the time set in the <property_name> property. If you have not selected this option or if you have not manually set the <property_name> property using the tssh command, the instances and devices along with the historical data is deleted only after 7 days. 

  6. Click Save to save the changes.

To edit a rule-based group

Perform the following steps to edit an existing group details:   

  1. Go to Configuration > Groups.
    All the parent groups are displayed in the Group Configuration page. 
  2. Expand the group name of the group that you want to update. If you want to update a child group, navigate to the child group name and expand it.
  3. Click the action menu console_actionMenu2.png next to the group name and select Edit Group.
  4. Do the required changes.
    You can add or remove parent groups, child groups, assigned devices, and monitor instances.
  5. Click Save.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*