This page applies to an earlier version of the AppDynamics App IQ Platform.
See the latest version of the documentation.

Skip to end of metadata
Go to start of metadata

Agent logs can help you resolve agent configuration and application instrumentation issues.

The Controller can generate and archive agent log files that you can submit to AppDynamics Support for troubleshooting assistance. See Request Agent Log Files for more information.

What is Logged

The beginning of the log file shows the startup of the agent monitoring services and the configuration settings. The agent log also contains the sequence of agent runtime activity and exceptions that are encountered. Much of this information is useful especially for troubleshooting deployment issues.

Examples of information in the log:

  • Agent version and build date
  • JVM runtime version (Java only)
  • Configuration changes
  • Backend detection
  • Exceptions 
  • Output from logging session requests

Logging Levels 

The logging levels, listed in order from collecting the most information to the least, are the following:

  • ALL: Logs all events.
  • TRACE: Reports finer-grained informational events than the debug level that may be useful to debug an application.
  • DEBUG: Reports fine-grained informational events that may be useful to debug an application.
  • INFO: Default log level. Reports informational messages that highlight the progress of the application a coarse-grained level.
  • WARN: Reports on potentially harmful situations.
  • ERROR: Reports on error events that may allow the application to continue running.

Not all agents types log at all levels.

Log Structure

This section describes how the agent logs are rolled over for the following agents:

  • Java Agent
  • .NET Agent
  • Proxy
  • BytecodeTransformer
  • Business Transactions
  • JMX
  • REST
  • Machine Agent
  • Dynamic Services (used internally)

When the maximum file size is reached, a new log file is created. The first file is named ...0.log, second file is ...1.log, and so on. There is a maximum of five files per set and a maximum of five sets for each instrumented node. If the maximum number of sets is reached, when a new set is created, the oldest set is deleted. 

While the agent rotates away old log files, it retains the intial log file. The first log file contains information that reflects the specific context in which the agent was started, along with other information that can be useful for troubleshooting and record keeping. On agent restart, a new set is created and the oldest set is deleted

Each set includes not only the application agent log but also, depending on which logs exist, the ByteCodeTransformer log, the REST log and the BusinessTransaction log. A single set might consist of the following:

  • agent.<timestamp>.#.log
  • ByteCodeTransformer.<timestamp>.#.log
  • REST.<timestamp>.#.log
  • BusinessTransaction.<timestamp>.#.log

where # is the number of the set.

For example, the following logs in the logs directory were created on April 3 or the first set (set 0). The agent is a Java Agent; this is indicated by the prefix "agent". Other app agents use different naming conventions (see the agent-specific information for details).


On the next agent restart a new set is created. The logs in this set, set 1, will have names such as:

. . . 

and the next set, set 2,

. . . 

and so on through the five potential sets.

Agent-Specific Information

AppDynamics agents have different logging locations and different maximum log sizes. See the related pages for logging documentation for details about the agent you are interested in.

  • No labels