Viewing and filtering agents

PATROL Agents are devices that monitor and manage an IT environment. As an administrator, use the Configuration > Agents page to view and manage PATROL Agents. An entry for a PATROL Agent is added to the page when you deploy it.

The table on the Agents page displays the following information:

• Name: Host name of the server where the PATROL Agent is installed. An icon is shown against each Agent to depict its connection status:
  • : Connected
  • : Disconnected
• Tags: Keywords or labels that identify and categorize or group PATROL Agents
• IP Address: IP address of the server where the Agent is installed.
• OS: Operating system that runs on the host server
• Version: Agent version
• Deploy Status: Icon that displays the deploy and install status of the Agent. For more information, see Configuring-deployable-packages.
• Additional Information: Icon that indicates the following information:
  • : Marked for delete
  • : Agent not managed by policies
• Policy Status: Status of the policies that are applied on the Agent. Hover over the following icons to know the list of policies that are applied on the Agent:
  
  • : Policy successfully applied
  • : Policy could not be applied

To create Agent filters

By default, the maximum number of PATROL Agents that can be displayed on the Agents page is 2000. If you have more Agents, create filters to view them.

On the Configuration > Agents page, click the main action menu and do the following:

1. Click Create Agent Filter.
2. Do one of the following:

   • Click Import Conditions from a Policy and select a policy. Define additional Agent filter properties and conditions if required.

     Details about Agent filter properties
   • Click Define Conditions and add conditions for the filter.
3. Save the filter.
4. Add a name for the filter and click Ok.
   The filter is applied to all PATROL Agents on the Agents page.

To modify filters

On the Configuration > Agents page, click the main action menu, and do the following:

1. Click View Saved Filters.
2. Click a filter action menu, and click Edit.
3. Make your changes and click Update.

To delete filters

On the Configuration > Agents page, click the main action menu, and do the following:

1. Click View Saved Filters.
2. Click a filter action menu, and click Delete.

To run a query on PATROL Agents

This option is available only for PATROL Agents that are in connected state.

You can run PSL commands on PATROL Agents by using the Agent Query Tool and view the results in the tool. You can also perform the following actions by using the tool:

• Restart the Agent. Use the  button.
• Reload the Agent. Use  the button.
• Stop the Agent. Use the  button.

On the Configuration > Agents page, click a device action menu, and do the following:

1. Click Query PATROL Agent.

2. Log in to the Agent with the host credentials. 

   Note

   If you are an administrator or a user with the manage_aqt_authentication permission, you can directly run PSL commands without having to enter the host credentials for authorization. For more information, see Roles and permissions.

3. In the Command box, do one of the following:

   • Manually enter a PSL command.
     In the Command box, type the command and press Enter or click Execute. For example, %DUMP ALL. The results are displayed. For more information about PSL commands, see PATROL Script Language overview and functions.

   • Click  and select a query from the out-of-the-box PSL commands list.
     In the Select Command dialog box, select a command and click Apply.

     Click here to view a list of available commands
4. Click Execute. The command and its results are displayed.

To view the Agent configuration history

This option is available only for connected Agents. To view the Agent configuration history, on the Configuration > Agents page, click the device action menu, and click Show History for Applied Configurations.