~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.

Icon Status Description

Connecting

The Agent is in the process of connecting to the Aggregation Server.

Reporting

The Agent is connected and reporting to the Aggregation Server.

Not Reporting

The mobile SDK did not report to the Aggregation Server for more than 5 minutes.

Disconnected

The Agent is disconnected from the Aggregation Server.

Stopped

The Agent is stopped. Communication services to the Aggregation Server remain connected.

Managing Agent State

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

Icon Status Description

Active

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.

Stopped

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.

Disabled

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.

Self-Stopped

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

Self-Disabled

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).