Viewing and filtering agents

PATROL Agents are devices that monitor and manage an IT environment. As an administrator, select Configuration > Agents 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
    When the PATROL Agent is deleted from a tenant, the devices or monitor entities that are associated with the PATROL Agent are deleted. Also, any alarm events that are associated with the deleted entity are deleted on the Events page. The reason for the alarm event closure is displayed on the Logs and Notes tab on the Event Details page. For more information, see Viewing-or-adding-notes-to-an-event.
  • : 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.

Select Configuration > Agents, click the main action menu, and perform the following steps:

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

   • 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

Select Configuration > Agents, click the main action menu, and perform the following steps:

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

To delete filters

Select Configuration > Agents, click the main action menu, and perform the following steps:

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.

Select Configuration > Agents, click a device action menu, and perform the following steps:

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, select Configuration > Agents, click the device action menu, and click Show History for Applied Configurations.