On this page:

You can manage app agents connected to the Controller from the AppDynamics Agents window. Click Settings > AppDynamics Agents > App Server Agents to view information, reset agents, disable agents, and more. 


To manage app agents, users must belong to a role with the following Account Level Permission:

Watch the Video


Agent Administration

Associate App Agents with a Business Application

If you start an application server with an app agent without specifying the business application, the agent appears in the App Server Agents tab as an unassociated agent. You can associate an agent with an application manually:

  1. From the agents list in the App Server Agents tab, select the unassociated app agent from the list.

    In the View menu, click Agents not associated with an Application to filter the list of App Server Agents.

  2. Click Associate with Application. This button is enabled only for app agents that are connected to the Controller but not associated with a business application. 

Reset App Agents

Resetting the app agent causes the agent to register itself with the Controller in the same way it does at JVM or application startup, but without restarting the JVM or application. Resetting the app agent purges in-memory data for the agent. It also applies certain configuration changes to the app agent, such as app agent node property changes. 

Resetting an app agent causes the Controller to:

Resetting an agent does not re-instrument or remove existing instrumentation. After a reset, the agent re-registers business transactions and backends and it creates new metrics. You may lose a few minutes worth of data between the reset and re-registration operations.

You may need to reset agents after you have reconfigured business transaction or backend detection and the agent is not applying the updated rules:

  1. Delete all existing transactions and backends.
    See "Delete Unwanted Business Transactions" in Business Transaction DetectionMonitor Databases,  and Monitor Remote Services.
  2. Choose a reset option:

Enable and Disable App Agents

An app server agent polls the Controller every minute to check whether the agent is enabled or disabled. Disabling an agent can help you troubleshoot application problems. For example, you don't need to uninstall the agent to compare the difference in overhead between when the agent is capturing data versus when it is not. Disabling the agent does not require you to shut down or restart the application server.

All agents connected to the Controller count against the agent license limits for that Controller. Even though it only reports minimal app server-related data, a disabled app agent is still connected to the Controller and consumes an app agent license.

Delete App Agents

Deleting an app agent removes the agent and any associated data from the Controller database. This does not affect the instrumentation of the application server. If the application server is still running with an app agent, or if it is subsequently restarted with an app agent, the agent re-registers and appears again in the Controller.

You can delete an app agent by clicking Delete Agent from System button.

To completely remove an app agent completely so that it does not register again, uninstall it. See the uninstall instructions for your agent's platform under Instrument Applications.