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

On this page:

Unzipping the Java Agent distribution archive extracts the following files and directories to the current directory.

Java Agent Directory Contents 

  • conf: Common configuration files. The configuration files in this directory are used by an agent if a more specific version of the configuration file does not exist in the version specific conf directory, ver<version_number>/conf
  • javaagent.jar: The common JAR file used to bootstrap the Java agent. To enable the agent, pass the fully qualified location of this file as the --javaagent argument value to the JVM at startup.
  • readme.txt: Instructions and notes for installing the Java agent. 
  • utils: Binary files for utilities shared across versions of the agent.  
  • ver<version_number>: The javaagent.jar file, configuration files, and other resources specific for this version of the Java agent. This directory contains most of the things that make the Java agent work, and is named to reflect the Java version number. 
    In 4.1, the ver4.1.0.0. directory contains: 
    • conf: The configuration files used by this version of the Java agent, including controller-info.xmlapp-agent-config.xml, and more. These settings in these files take precedence over configuration file in the <agent_home>/conf directory. 
    • external-services: Dynamically loaded modules that extend the agent, such as the Application Analytics dynamic service.
    • javaagent.jar: A version-specific JAR file that serves as the Java agent binary. Do not use this Java agent JAR when configuring instrumenting directly. Use javaagent.jar in the root directory instead. 
    • lib: Libraries that support the operation of this version of the Java agent.  
    • logs: Log files written by the agent.
    • sdk: Samples, APIs, and Javadoc for extending the capabilities of the AppDynamics Java agent.
    • utils: Binary files for utilities that are specific to this version of the agent.

Contents of the conf Directory

The files located in this directory are commonly used for agent configuration and deployment.

  • transactions.xml: Configuration settings for business transactions identified by the agent.
  • controller-info.xml: Configuration settings that identify the node, tier, and application associated with the data that this agent reports to the AppDynamics Controller, along with connection settings for the Controller. For more information, see Java Agent Configuration Properties.
  • app-agent-config.xml: Local configuration settings for this agent. The settings in this file override any equivalent settings specified globally for the AppDynamics deployment. This file is typically used for short-term properties settings or for debugging agent issues.
  • jmx: Files for configuring the JMX and Websphere PMI metrics.
  • logging/log4j.xml: Flags to control logging levels for the agent. It is highly recommended not to change the default logging levels.

Modifying the Log Directory Location

To specify a different log directory, use the following system property: