Page tree
    Skip to end of metadata
    Go to start of metadata

    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

    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.

    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 ServicePATROL Agents connected to the selected Integration Service.
    Infrastructure Management ServerPATROL Agents connected to the selected Infrastructure Management Server.
    Monitoring Solution Name1PATROL Agents on which the selected monitoring solution is installed.
    Monitoring Solution Version1PATROL Agents on which monitoring solutions of the specified version are installed.
    Tenant NameName 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