~Agent Administration~

This view displays a list of selected End Points (servers, desktops, tablets, or smartphones) on which Aternity Agents or the mobile SDK are installed, and provides basic information about each End Point. By default, the list is not populated. You can use the Search tool to specify the End Points to display, or you can view all End Points.The information displayed in the grid is configurable, according to individual system attributes.

The Agent Admin view enables management tasks involving Agent function, such as:

  • Evaluating the success of Agent deployment
  • Viewing Agent properties, including Agent version, Aggregation Server handling the Agent, log level (default, debug, or trace), health status, connection status, and type (server, desktop, tablet or smartphone)
  • Reviewing pending agents and selectively approving them to collect data.
  • Temporarily stopping Agents during troubleshooting or maintenance procedures

The health status of an Agent is represented by a color-coded icon:

  • Green: Agent is healthy.
  • Red: Agent is unhealthy. The cause of the unhealthy status is displayed in the tooltip of the icon. Causes can be data loss, user experience risk, or both.
  • Gray: Health status of the Agent is unknown. An unknown health status is displayed by Agent versions that do not support the health status feature, and by newly installed Agents that have not yet reported their health status.

Selecting a row in the grid opens the Agent State Screen for the selected Agent. For details, refer to Agent Status View.

Agent Connection Status

Agent connection status refers to the state of the Agent’s communication with the Aggregation Server.

Field Description

The status of a device is Reporting if Aternity is actively receiving monitoring data from that device.


(For Windows and Macs) The status of a device is Disconnected if Aternity has not received monitoring data for more than five minutes from this device, but it has received data within the last 7 days.

This could be caused by powering off the device (may be company policy to switch off every night), or it may not have a license to report to Aternity, or it could point to a problem with the device, like no network connection.

When the Agent is disconnected, it locally stores up to 50 minutes of retention data in offline mode, and then sends it when it renews its connection.


(For Windows and Macs) The status of a device is Stopped if its Agent behaves unusually (like high CPU or memory usage), and therefore it automatically shuts down. Contact Customer Services.

(For mobile devices) Aternity Mobile reports a status Stopped when it does not collect performance data, but can still receive commands from the Aggregation Server.

Not Reporting

(For monitored mobile apps only) The status of a device is Not Reporting if Aternity has not received monitoring data from this mobile device for at least 10 minutes. This could happen if the device is shut down, or the device has no network data connection, or the mobile app is running in the background or is not running at all.

To determine the cause, drill down to other dashboards like Monitor an Application or Monitor Enterprise Applications.

Managing Agent State

Possible Agent states are listed and described in the following table.

Icon Status Description


The Agent is collecting measurements and reporting them to the Management Server.

Pending Approval

The Agent remains dormant and will not collect information unless it is manually approved to collect it.


The Agent is not collecting measurements, but can still accept commands from the Management Server. Stopping an Agent can be useful in situations where there may be conflicts between the Agent and another application. An administrator can temporarily stop the Agent, resolve the issue, and restart the Agent remotely by changing its mode back to active.


The Agent is completely disabled. Re-enabling the Agent can be done only by accessing the Agent machine and starting the Agent service. Disabling an Agent is generally done during maintenance or upgrade procedures, e.g., updating files or changing configuration.


The Agent moved to Stopped mode on its own, due to internal issues.


The Agent moved to Disabled mode on its own, due to internal issues.

The state of an Agent can be managed via the Aternity Console by using the Change Agent State feature, at the bottom of the Agent Admin grid. The feature is activated by selecting the checkbox(es) at the far left side of the row(s) of the relevant End Point(s).