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"

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.

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.
    mdevices_createfilter.png
  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

agent_selection.png

  1. Select a property.
  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.
  4. (Optional) To add more than one condition, click the add_condition.png button, and perform the earlier steps.
  5. (Optional) To group the conditions, use the following parentheses and Boolean operators from their corresponding lists:
    • (
    • ((
    • (((
    • )
    • ))
    • )))
    • AND
    • OR
  6. (Optional) To remove any existing condition, click the remove_condition.png button.
  1. Click Apply. The filtered PATROL Agents are listed in the Managed devices table.
    AgentFilterCreateApply.png

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.
    mdevices_viewfilter.png
    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.
    AgentFilterApplied.png

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.
    mdevices_editfilter.png
  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.
    mdevices_delfilter.png
    The selected saved filter is removed from the list.

Where to go from here

Performing-actions-on-a-PATROL-Agent

 

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