Reset App Agents

Attention: To reset app agents, users need the "Agent Advanced Operation" permission.
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:

  • Purge data such as in-memory business transactions and metrics, exit calls, and registration information for the agent
  • Reset the business transaction limit counter to zero for the selected agent

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 information on deleting unwanted business transactions in Transaction Detection Rules, Monitor Databases, and Remote Services.
  2. Choose a reset option:
    • To reset all the app agents for a business application, click Reset Agents.
    • To disable a individual app agents, select one or more agents and click Reset Selected App Agent(s).