View Agent Status and Manage Agent Cards

Use the Agents View to monitor the health and performance of the agents that are available in your environment. The Agents View page is an overview with all important agent information in one place. In the view, Agent cards show details for one agent or a group of agents. If more agents are grouped in a card, the metrics information is also grouped. You can perform the following actions with the Agent or Agent card:
View Agent Status
The Agents View lets you determine the agent connectivity status, any problems with overload, or when the agent does not collect metrics. You can view information in live mode or you can select a historic time range. 
Follow these steps:
  1. Click
    Agents View
    in the left pane.
    An Agent card shows details for one agent or a group of agents. If more agents are grouped in a card, the metrics information is also grouped. The Agents View shows all agents for the environment and the following metrics: 
    • CPU
      Shows the percentage of the CPU that is being used. 
    • Heap Memory
      Shows the percentage of memory that is being used.
      In the CPU and Heap Memory line chart, mouse over a peak in the metric behavior in the graph. Select and zoom in to a problematic time range.
    • GC Time
      Shows the percentage of time interval that is spent in the garbage collector for the currently selected time range.
    • Metrics Collected
      Shows the number of metrics that are collected by agents.
      If the card only contains information for one agent, more granular attribute details such as hostname or uptime are shown. If there are more agents in a card, you can see Application count, Agent count, and Collector count.
  2. (Optional) Click the card title to show a perspective from which you want to group the agents, for example: Type. The default perspective is Name.
    The available perspectives are based on attribute names so the agents are grouped based on their attributes. 
  3. (Optional) Click
    Isolation View
    .  A new tab opens the map in the
    APM Infrastructure Layer
    . The map shows the components that share the attribute value as an expanded group. A temporary perspective removes higher levels of grouping. Isolation view applies a transaction path filter so that the map shows all complete transactions that pass through the components.
  4. Open an Agent card and select one of the following options from the
    Sorted by
     drop-down list:
    • Health Score
      Shows the overall health of agents. Various alerts on agents are monitoring metrics such as the CPU or the connectivity of the agent. The health score percentage counts the alerts for the last 24 hours. If any of the monitored alerts are triggered in the last 24 hours, the Health score percentage goes down. For example, Health score of 100 percent means that no alerts were triggered in the last 24 hours. Health score of 50 percent means that in the last 24 hours some alerts were shown for the total duration of 12 hours.
    • Connection
      Shows how many agents are available in your environment and how many agents are disconnected.
    • Highest CPU
      Shows cards with the highest CPU usage first.
    • Highest Memory
      Shows cards with the highest memory usage first.
  5. (Optional) Click
    View as List
    . A list is an alternative to Agent cards and shows more data on one page, in a concise way. Click a column name to sort by. Click a line to expand Agent data. 
Add an Agent Card
Agent cards let you divide your agents into meaningful groups based on their attributes. By default, you have one Agent card with all agents. As an administrator, you can add new Agent cards.
Follow these steps:
  1. In the Agents View top page, click the plus sign next to the existing Agent cards.
    A new window
  2. Name the card and follow the instructions in the window. 
    • Select a universe
      In most Enterprise Environments, the total number of components is too large to visualize efficiently. Universes let the administrator refine the number and types of components into meaningful groups. This refined group is a Universe. For security reasons, there is no default assignment to all users. You must be allocated to a Universe to view information. 
    • Apply a Filter
      Use the entire Universe or apply a filter.
    • Include Experience node
      Experience is the first monitored front-end component and the beginning of the transaction path. An experience node contains an extra attribute called Experience. If you check Include experience node, the filtered results include the node showing where the transaction was initiated.
    • Group by
      Select Attributes according to which you want to drill down into further levels of the Agent card.  
    • Default chart type
      CPU / Heap Memory
      Number of collected metrics / GC Time
      Attributes summary
  3. If you want to make the card public, select
    Make this Agent Card public
    If you do not select this option, the card is private and only you can see the card. If you select this option, the card is public and all users that have access to the relevant universe can see the card.
  4. Click
You added an Agent Card.
Edit an Agent Card
You can edit agent cards, for example, if you want to select different attributes as drill-down levels. 
Follow these steps:
  1. In the Agents View top page, select the card that you want to edit.
  2. Click the settings button on the card.
  3. Click
    Edit Card
    A new window 
    Edit Agent Card
  4. Edit the card.
  5. Click
You edited an Agent Card.
Delete an Agent Card
You can delete the agent cards that you no longer want to use.
Follow these steps:
  1. In the Agents View top page, select the card that you want to edit.
  2. Click the settings button on the card.
  3. Click 
    Edit Card
    A new window 
    Edit Agent Card
  4. Click
    Delete Card
  5. In the deletion confirmation pop-up window, click
You deleted an Agent Card.
Share an Agent Card
As an administrator, you can share an Agent card with a user within an existing universe.
Follow these steps:
  1. Check that the user has access to the universe.
  2. On the Agent card, select 
    Make This Card Public
    The card appears in your list of cards.
  3. Send the Agent card link to the user.
    You can share a private Agent card with a user from the same universe. The user can temporarily view the private card.