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 is named to reflect the Java Agent version number, such as ver4.4.0.5.
    Among other things, the 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 Analytics Data Sources 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.