> ## Documentation Index
> Fetch the complete documentation index at: https://docs.levelblue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Filtering Rules from the Orchestration Rules Page

|                       |           |              |             |             |
| --------------------- | --------- | ------------ | ----------- | ----------- |
| **Role Availability** | Read-Only | Investigator | **Analyst** | **Manager** |

USM Anywhere enables you to make the <Tooltip tip="Sensors are deployed into an on-premises, cloud, or multi-cloud environment to collect logs and other security-related data. This data is normalized and then securely forwarded to USM Anywhere for analysis and correlation.">sensor</Tooltip> drop future <Tooltip tip="Any traffic or data exchange detected by LevelBlue products through a sensor or external devices such as a firewall.">events</Tooltip> that match the rule. These future events are neither correlated nor stored. Through these rules, you are able to define which event data you are going to store in USM Anywhere. You pay for the data you use, so discarded event information is not stored and does not count against the service-level tier of an account. This rule runs on a sensor and control node. The action of this rule has no recovery, so you must be careful when creating the rule. This action can cause a user-generated data loss environment.

<Note>
  **Note:** Filtering rules are not retroactive. The rule applies to future items and it does not apply to previous items, even if those items follow the rule.
</Note>

<Warning>
  **Important:** You can't use a correlation list when you create a filtering rule.
</Warning>

**To create a rule for filtering events**

1. Go to **Settings > Rules**.

2. Select **Create Orchestration Rule > Filtering Rule**.

   <Frame>
     <img src="https://mintcdn.com/levelblue-5324744e/WKvzNH1Td8kzeWqz/images/usm-anywhere/createfilteringrule.webp?fit=max&auto=format&n=WKvzNH1Td8kzeWqz&q=85&s=014710ae3bb50beeb3a041e457267332" alt="" width="1058" height="481" data-path="images/usm-anywhere/createfilteringrule.webp" />
   </Frame>

3. Select a Boolean operator.

   The options are AND, OR, AND NOT, and OR NOT.

4. Select a packet type in the Match drop-down list.

   <Frame>
     <img src="https://mintcdn.com/levelblue-5324744e/JttNYaikKbN1las-/images/usm-anywhere/matchcombofiltsupp.webp?fit=max&auto=format&n=JttNYaikKbN1las-&q=85&s=ef7be78ac0d34c2a47ca89c8bc6813df" alt="" width="308" height="263" data-path="images/usm-anywhere/matchcombofiltsupp.webp" />
   </Frame>

   * **Logs:** Use this packet type for event-based rules.
   * **Configuration Issues:** Use this packet type for configuration issues-based rules1.
   * **Vulnerabilities:** Use this packet type for vulnerabilities-based rules.
   * **Alarms:** Use this packet type for console user alarms-based rules.

5. Click **Add Conditions** and select the property values you want to include in the rule to create a matching condition.

   <Note>
     **Note:** If the field is related to the name of a country, you should use the country code defined by the [ISO 3166](https://www.iso.org/iso-3166-country-codes.html).
   </Note>

   <Note>
     **Note:** The Sources or Destinations field needs to match the universally unique identifier (UUID) of the event or alarm. You can use the Source Name or Destination Name field instead.
   </Note>

   <Warning>
     **Important:** Instead of using the `equals` and `equals`, `case insensitive` operators for array fields, LevelBlue recommends the use of the in or contains operators.
   </Warning>

   <Note>
     **Note:** If you need to add a property value that maps with a property key, you need to know the mapping of the field. See [Determining the Mapping](/documentation/usm-anywhere/user-guide/rules-management/mapping-field) of a Field for more information.
   </Note>

6. (Optional.) Click **Add Group** to group your conditions.

   <Note>
     **Note:** See [Operators in the Orchestration Rules](/documentation/usm-anywhere/user-guide/rules-management/orchestration-rules-operators) for more information.
   </Note>

7. In the **Occurrences** text box, enter the number of event occurrences that you want to produce a match on the conditional expression to trigger the rule.

   You can enter the number of occurrences or use the arrows to scroll the value up or down. You can enter a number between 1 and 100.

   <Note>
     **Note:** The current rule box shows you the syntax of your rule, and the rule verification box reviews that syntax before saving the rule.
   </Note>

8. Click **Next**.

   <Frame>
     <img src="https://mintcdn.com/levelblue-5324744e/MlnJpGwLYAWOIbAS/images/usm-anywhere/ruleverification.webp?fit=max&auto=format&n=MlnJpGwLYAWOIbAS&q=85&s=db9109c8ba7ebb9fd8e01d9dae4b1987" alt="" width="358" height="234" data-path="images/usm-anywhere/ruleverification.webp" />
   </Frame>

   <Warning>
     **Important:** A dialog box opens if there are warning messages. Click **Cancel** to review the warning messages, or click **Accept** to continue creating the rule.
   </Warning>

9. Enter a name for the rule.

10. (Optional.) Enter a description for identifying this rule.

11. Click Save.

    The created rule displays in the list of rules. You can see it from **Settings > Rules**. See [Orchestration Rules](/documentation/usm-anywhere/user-guide/rules-management/orchestration-rules) for more information.

    <Warning>
      **Important:** It takes a few minutes for an orchestration rule to become active.
    </Warning>

**To test the match criteria of a filter rule**

1. Create a test event suppression rule.

2. Add the desired match criteria for the target filter rule action.

3. Enable the rule.

4. Go to Settings > Rules to verify that the rule is working as desired.

5. In the All Orchestration Rules page, click the <img src="https://mintcdn.com/levelblue-5324744e/7_UE4nawuffikKei/images/usm-anywhere/external-link.svg?fit=max&auto=format&n=7_UE4nawuffikKei&q=85&s=4a6d797fd7e9276fbea6a4901fe1e1b9" className="inline" width="20" height="20" data-path="images/usm-anywhere/external-link.svg" /> icon of the filter rule you want to test.
   The events, which triggered the rule and are suppressed, display.

6. Create a filtering rule with the exact same match criteria if the event information displayed is correct. If the event information displayed is not correct, modify the suppression rule match criteria until the correct values are found that suppresses the correct event data. Then generate the filter rule.

**To filter filtering rules by name**

1. Go to **Settings > Rules**.
2. Click the box next to Filter By.
3. Enter your search.

**To filter filtering rules by rule status**

1. Go to **Settings > Rules**.
2. Click the combo box next to Rule Status.
3. Select **All Rules**, **Enabled**, or **Disabled**.

**To edit a filtering rule**

1. Go to **Settings > Rules**.
2. Click the <img src="https://mintcdn.com/levelblue-5324744e/2zcwC17_yhGqZqy4/images/usm-anywhere/pencil-new.svg?fit=max&auto=format&n=2zcwC17_yhGqZqy4&q=85&s=3fe3fa0ee6ce2b44857bf81d5ab975d9" className="inline" width="24" height="24" data-path="images/usm-anywhere/pencil-new.svg" /> icon of the rule you want to edit.
3. Modify the data of the items that need to be modified.
4. Click **Next**.
5. Click **Save**.

**To delete a filtering rule**

1. Go to **Settings > Rules**.
2. Click the <img src="https://mintcdn.com/levelblue-5324744e/9HhQ6wK11ydctaHc/images/usm-anywhere/trash-alt.svg?fit=max&auto=format&n=9HhQ6wK11ydctaHc&q=85&s=2a750f9ee3d6466fc6799984309cddf0" className="inline" width="24" height="24" data-path="images/usm-anywhere/trash-alt.svg" /> icon of the rule you want to delete.
3. Confirm by clicking **Accept**.

**To enable a filtering rule**

1. Go to **Settings > Rules**.
2. Click the <img src="https://mintcdn.com/levelblue-5324744e/9HhQ6wK11ydctaHc/images/usm-anywhere/toggle-off-new.svg?fit=max&auto=format&n=9HhQ6wK11ydctaHc&q=85&s=bed00ce5e148a8148e763548ae6c8199" className="inline" width="32" height="16" data-path="images/usm-anywhere/toggle-off-new.svg" /> icon of the rule you want to enable.

**To disable a filtering rule**

1. Go to **Settings > Rules**.
2. Click the <img src="https://mintcdn.com/levelblue-5324744e/9HhQ6wK11ydctaHc/images/usm-anywhere/toggle-on-new.svg?fit=max&auto=format&n=9HhQ6wK11ydctaHc&q=85&s=b0ecf1b6c804d5cf5eac9ea50b41480d" className="inline" width="32" height="16" data-path="images/usm-anywhere/toggle-on-new.svg" /> icon of the rule you want to disable.

**To enable all filtering rules**

1. Go to **Settings > Rules**.
2. In the list of rules, select the first checkbox in the first column to select all the rules.
3. Click **Enable All Rules**.

**To disable all filtering rules**

1. Go to **Settings > Rules**.
2. In the list of rules, select the first checkbox in the first column to select all the rules.
3. Click **Disable All Rules**.
4. Confirm by clicking **Accept**.
