AppDynamics provides flexibility for configuring the Machine Agent so that you can choose the best fit for your deployment environment.
Not all options are available for all properties. See Machine Agent Configuration Properties.
Configure the Machine Agent Properties
You can configure the Machine Agent by:
- Editing the
controller-info.xmlfile located in the
- Adding Agent system properties (
-D<system_property>) to the Machine Agent start-up script or on the command line.
- Using environment variables. To configure the Agent with environment variables, set the value of the environment variable in the environment where the monitored application runs and restart the Agent. Environment variables exist for most of the Agent settings in the
controller-info.xml file, but not all settings are configurable through environment variables. For those settings, you need to use system properties or
controller-info.xml. See Machine Agent Configuration Properties.
Empty spaces and special characters are not allowed in either the full path to the Machine Agent home directory, or in the directory name itself. If the Machine Agent does not start up, review the path to determine if it contains empty spaces or special characters. For example, the path
machine agent is problematic, however, the path
machine-agent works correctly.
The JVM system properties and environment variables override the settings in the
controller-info.xml file. The Agent applies the first non-empty value for a configuration property. The Machine Agent applies configurations using the following sources (in order).
- Environment variables
- System properties passed in the
startcommand for the JVM
Global configuration file:
See Where to Specify Machine Agent Configuration for OS environment and install package details
Machine Agent controller-info.xml File
<?xml version="1.0" encoding="UTF-8"?> <controller-info> <controller-host>your-controller-host</controller-host> <controller-port>your-controller-port</controller-port> <account-access-key>your-access-key<account-access-key> <controller-ssl-enabled>true</controller-ssl-enabled> <enable-orchestration>false</enable-orchestration> <sim-enabled>false</sim-enabled> <unique-host-id>your-host-id</unique-host-id> <account-name>your-account-name</account-name> </controller-info>
bash command-line Example
<machine_agent_home>/bin/machine-agent -Dappdynamics.controller.hostName=your-controller-host -Dappdynamics.controller.port=your-controller-port -Dappdynamics.agent.accountAccessKey=your-access-key -Dappdynamics.agent.uniqueHostId=your-host-id -Dappdynamics.agent.accountName=your-account-name