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.
  If a PATROL Agent's status remains Disconnected continuously for 60 days, the Agent is automatically deleted within the next 24 hours.
• 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.
    Important: If a PATROL Agent is in the Disconnected state, the monitored objects and devices associated with it are marked for deletion. If the Agent remains in the Disconnected state for 60 days, the monitored objects, devices, and the PATROL Agent are automatically deleted in the following order:
    1. The monitored objects associated with the devices in the PATROL Agent
    2. The devices associated with the PATROL Agent
    3. The PATROL Agent
  • : 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. On the Agent Connection page, enter the PATROL Agent user name and password, and click Connect.
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.