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


On this page:

Your Rating:
Results:
PatheticBadOKGoodOutstanding!
48 rates

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 for 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.  

To set the node name for the agent using an environment variable, set the value of the APPDYNAMICS_AGENT_NODE_NAME environment variable as you normally would for the operating system you are using and restart the JVM.

For example, to set the variable from the Linux command line, enter this command: 

export APPDYNAMICS_AGENT_NODE_NAME=node23

When the agent subsequently starts up, it takes node23 as its node name. 

Environment Variables Used by the Agent

The Java Agent takes configuration settings from the following environment variables, when set: 

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<account-name>
APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY<account-access-key>
APPDYNAMICS_AGENT_UNIQUE_HOST_IDUnique host name
APPDYNAMICS_AGENT_BASE_DIR<agent-runtime-dir>

Notice that not all configurable agent settings are configurable through environment variables. For those settings, you need to use system properties or controller-info.xml, as described on Java Agent Configuration Properties

  • No labels