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.

The default maximum number of PATROL Agents that can be displayed is 2000. You can change the display limit by entering the following command in the command prompt window:

tssh properties set managedDevicePageAgentCountLimit <numerical_value>
tssh properties reload

Note

BMC recommends 2000 to be the limit for the number of devices that are displayed. Increasing the limit of devices to be displayed can adversely affect system performance.

You can reduce the number of devices to be displayed to improve system performance.

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

Property Description
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"
  • The value of the in list operator can be a comma-separated list of Agent host names. You cannot provide host names exceeding the limit of 4000 characters (including the comma separator and blank space). 
    Example: Suppose you want to add the Agents named, vw-pun-662266virtual-mc-122, and win-clm-3355. In this scenario, you can provide the following Agent selection criteria:
    Agent Host Name in list vw-pun-662266, virtual-mc-122, win-clm-3355
Agent Port

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

Use port numbers from 1025 to 65535.

Agent Version Version of the PATROL Agent.
Agent Operating System Operating system of the computer on which the PATROL Agent is installed.
Agent IP Address IP 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 Tag

Tag applied on the PATROL Agent.

Note: The agent tag value cannot contains special characters such as, single quotation marks ('), double quotation marks ("), ampersand (&), angle brackets (< >), pipe (|), and braces ({ }).

Integration Service PATROL Agents connected to the selected Integration Service.
Infrastructure Management Server PATROL Agents connected to the selected Infrastructure Management Server.
Monitoring Solution Name1 PATROL Agents on which the selected monitoring solution is installed.
Monitoring Solution Version1 PATROL Agents on which monitoring solutions of the specified version are installed.
Tenant Name Name of the tenant to which the PATROL Agent are associated via the Integration Service.

1 - The Monitoring Solution Name property is only applicable to PATROL Agent version 10.0 and later.


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