This page applies to an earlier version of the AppDynamics App IQ Platform.
For documentation on the latest version, see the 4.4 Documentation.


Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

As an alternative to using system properties or controller-info.xml to configure the application name, tier name, and so on, you can configure the agent based on environment variables. Environment variables give you another mechanism for configuring the agent based on dynamically set values.    

About Environment Variables

To configure the agent with environment variables, simply set the value of the appropriate environment variable in the environment in which the monitored application runs.

There are environment variables defined most of the agent settings you can configure in the controller-info.xml file. For example, there are variables for the application name, node name, Controller connection settings, and more.  

For example, to set the node name for the agent using an environment variable, use the APPDYNAMICS_AGENT_NODE_NAME variable. The following command sets the variable to node23. When the agent subsequently starts up, it automatically takes node23 as its node name: 

export APPDYNAMICS_AGENT_NODE_NAME=node23

Since an agent setting can be specified in several places, the agent applies the following order of priority in taking a value for the setting:  

  1. Environment variable 
  2. System property 
  3. controller-info.xml

For each setting, the agent checks each of these sources. For the value, the agent uses the value from the first source that contains a non-empty value (based on the order shown).

Environment Variables

You can use the following environment variables to configure the Java Agent. 

Environment VariableEquivalent property
APPDYNAMICS_CONTROLLER_HOST_NAME<controller-host>
APPDYNAMICS_CONTROLLER_PORT<controller-port>
APPDYNAMICS_CONTROLLER_SSL_ENABLED<controller-ssl-enabled>
APPDYNAMICS_AGENT_APPLICATION_NAME<application-name>
APPDYNAMICS_AGENT_TIER_NAME<tier-name>
APPDYNAMICS_AGENT_NODE_NAME<node-name>
APPDYNAMICS_AGENT_ACCOUNT_NAME_ENV_VAR<account-name>
APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY_ENV_VAR<account-access-key>
APPDYNAMICS_AGENT_UNIQUE_HOST_ID_ENV_VARUnique host name
APPDYNAMICS_AGENT_BASE_DIR<agent-runtime-dir>
  • No labels