Viewing and removing offline agents

Edit online

After an agent has been offline for four days, it is removed from the Cloud APM console. Review how offline agents are indicated and the effect on resource groups, topology views, and other features. Use the application editor to remove a managed system from the dashboard before the four days have passed. You can also adjust the timing for removing offline managed systems..

About this task

After agents are installed on the systems that you want to manage, they connect to the Cloud APM server and send data samples to the Application Performance Dashboard for presentation and threshold evaluation. If the agent is offline, the Unknown status indicator is displayed in the navigator and in the dashboard. The server waits for a specific number of intervals to pass with no response from the agent before showing that the agent is unavailable. See Examples of offline agents.

After four days, the offline agent is removed from the user interface with the following exception: If the agent is one that supports transaction tracking, the offline agent continues to show in the Aggregate Transaction Topology and Transaction Instance Topology views.

You can remove the offline agent from any defined applications, which removes it from the Cloud APM console before the four-day waiting period is complete. For future occurrences of offline agents, you can also adjust the wait time before the offline agent is removed from view. See What to do next at the end of this topic.

Procedure

Take these steps to remove an offline agent from a defined application:

  1. If the Application Performance Dashboard is not displayed, select it from the Performance menu or, if you are on another console page, click the Home link.
  2. In the Applications section of the navigator, select the application that the offline agent is a component of and click Edit Application.
    Dashboard navigator showing the toolbar in the Applications section
  3. Select the agent or agent subnode in the Application Components list and click Delete.
    For agents that have subnodes, select the agent alone by clicking the name while the tree is collapsed, select the node and all subnodes by expanding the node tree (click Expand icon) and clicking the node, or select individual subnodes by expanding the node tree and clicking the instance.
    Edit Application pop-up window, application component selected, Delete tool clicked, and message asking the user to confirm.
  4. After you are finished editing the application to remove the offline agent or subnode, click Save.

Results

Your application updates are completed by the Cloud APM server after you save your changes. It might take a few minutes before the offline agent is removed from the Application Performance Dashboard.

What to do next

You can adjust the Remove Offline System Delay setting in the Advanced Configuration page to increase or decrease the wait time before the offline agent is removed from view. For more information, see Agent Subscription Facility.