Configuration Options and Precedence

You can control many aspects of the operation of the Java Agent through its configuration settings. The agent provides several approaches for specifying these settings, as listed below.

The order of the list matches the priority of the settings. The agent applies the first non-empty value for a configuration property it encounters, given the following order.

  1. Environment variables. See Use Environment Variables for Java Agent Settings.
  2. System properties passed in the start command for the JVM.
  3. Versioned agent properties: <agent_home>/<version_number>/conf/agent.properties .
  4. Global agent properties: <agent_home>/conf/agent.properties .
  5. Versioned configuration file: <agent_home>/<version_number>/conf/controller-info.xml
  6. Global configuration file: <agent_home>/conf/controller-info.xml
Note: Not all properties are available as environment variables, system properties, or XML elements for the controller-config.xml. Property references include only the available configuration methods.