Filtering PATROL Agents

Use the Agent filter functionality to filter out PATROL Agents based on predefined properties and display a specific list of PATROL Agents on the Managed Devices page.

You can perform actions such as install or deploy packages, or modify policy management settings, on this filtered list.

Related topic

For more information about displaying specific PATROL Agents, see

Managing Infrastructure Management devices from the TrueSight console

Agent Filter properties

PropertyDescription
Agent Host Name

Host name of the computer on which the PATROL Agent is installed.

Note: The value for the matches property must be a strict regular expression. Some examples of regular expressions that can be used:

  • virtual_machine -- To select Agents that match the exact string "virtual_machine
  • .*?virtual_machine.* -- To select Agents that match the sub-string "virtual_machine"
  • ^((?!clm-pun).)*$  -- To select Agents that do not match the sub-string  "clm-pun"
Agent Port

Port number through which the PATROL Agent listens for incoming connections from the PATROL console.

You can use port numbers from 1025 to 65535.

Agent VersionVersion of the PATROL Agent.
Agent Operating SystemOperating system of the computer on which the PATROL Agent is installed.
Agent IP AddressIP address of the computer on which the PATROL Agent is installed. If you select the Agent IP Address in the range condition, only IPv4 range is supported.
Agent TagTag applied on the PATROL Agent.
Integration ServiceDisplay name of the Integration Service.
Infrastructure Management ServerHost name of the Infrastructure Management Server that is registered with the Presentation Server.

You can set multiple conditions and also group the conditions to identify the agents.

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

To create a filter

  1. Log on to the TrueSight console.
  2. Expand Configuration and select Managed Devices.
  3. From the Main action menu, select Create Agent Filter.
  4. In the Create Agent Filter section, specify filtering conditions in one of the following ways:
    1. To reuse the criteria from an existing policy, select Import Conditions From a Policy.
    2. To define a new filtering criteria, select Define Conditions and specify values for the relevant properties. To understand the list of available properties, see Agent Filter properties.

       Click here for detailed steps


      1. Select a property.
      2. Select an operator to create the condition. The available operators depend on the property that you select.
      3. (Optional) To add more than one condition, click the button, and perform the earlier steps.
      4. (Optional) To group the conditions, use the following parentheses and Boolean operators from their corresponding lists:
        • (
        • ((
        • (((
        • )
        • ))
        • )))
        • AND
        • OR
      5. (Optional) To remove any existing condition, click the  button.

  5. Click Apply. The filtered PATROL Agents are listed in the Managed devices table.

To save a filter

  1. Create a filter.
  2. Click Save.
  3. Specify a unique name for the filter and click OK.
  4. (Optional) To create a copy of the filter with modified or new conditions, click Save As. Specify a unique name for the filter and click OK.

To display saved filters

  1. Log on to TrueSight console.
  2. Expand Configuration and select Managed Devices.
  3. From the Main action menu, select View Saved Filters.

    A list of the saved filters is displayed as separate buttons.

To use a saved filter

After you save an Agent filter, you can use it at any time to filter out the unwanted PATROL Agents.

  1. Display saved filters.
  2. Click the saved filter button that you want to apply.
    The filtered PATROL Agents are listed in the Managed devices table. The name and conditions for the selected filter are displayed in the right pane above the table.

To modify a saved filter

  1. Display saved filters.
  2. For the saved filter that you want to modify, click the filter action menu and select Edit.
  3. Modify the filter conditions and click Update.

To delete a saved filter

  1. Display saved filters.
  2. For the saved filter that you want to delete, click the filter action menu and select Delete.

    The selected saved filter is removed from the list.

Where to go from here

Performing actions on a PATROL Agent

Was this page helpful? Yes No Submitting... Thank you

Comments