About Connecting the App Agents and the Controller
Before an App Agent can upload data to the Controller, you must configure its connection to the Controller. Agents connect to the Controller through the same port as the browser connection for the UI, on port 8090 by default.
If needed, you can configure the agent to connection through a web proxy for the Controller. It can also connect to the Controller using an SSL connection. See Implement Security for information on using SSL.
Configuration File Locations for App Agents
Although the different agents have similar configuration properties, the way you configure the Controller connection varies slightly among the different types of agents, as described here.
Configure Controller connectivity for the App Agent for Java the following places:
- <agent install directory>/conf/controller-info.xml
- In the system properties (-D options) in the JVM startup script
The system properties override the settings in the controller-info.xml.
Configure the agent properties in the config.xml file in the agent Config directory. If you run the .NET Agent Configuration Utility, it writes the config.xml to the following locations: Windows Server 2008 and later Windows Server 2003
Windows Server 2008 and later
Windows Server 2003
The App Agent for .NET includes the AppDynamics Agent Configuration utility to assist configuration. See Configure the App Agent for .NET.
For more information, see:
Configure Controller connectivity for the App Agent for PHP in <agent install directory>/proxy/conf/controller-info.xml.
When you install the PHP agent, provide the relevant Controller connection information. The install script writes the configuration to the controller-info.xml.
For more information, see:
Configure controller connectivity in the AppDynamics require statement that you paste into the application source code at the first line of the main module before the other require statements.
For more information see:
Configure Controller connectivity for standalone machine agents in <machine agent install directory>/conf/controller-info.xml.
Common Controller Connection Properties
The Controller configuration properties common to all agents are:
- Controller Host
- Controller Port
- Controller SSL Enabled
- Application Name
- Tier Name
- Account Name for SaaS
- Account Access Key or Password for SaaS
Securing the Connection
The on-premise Controller is installed with an active secure port by default. App Agents can use the secure port to connect to the Controller.
The certificate used for the connection out-of-the-box is a self-signed certificate. The .NET agent cannot connect on a secure port that uses a self-signed certificate, so you will need to apply your own certificate to the port. App Agents connecting to an AppDynamics SaaS Controller also must use an HTTPS connection.
The default secure listening port for the AppDynamics Controller are:
- For on-premise Controllers, port 8181
- For SaaS Controllers, port 443
To implement SSL for controller-agent communication do the following:
- Set the application server primary port to the SSL port, by default 8181. See Controller Port Settings.
- Install a trusted certificate, see Controller SSL and Certificates.
- Configure your agents for SSL. See the following sections, App Agent Security and Machine Agent Security, for more information.
The SaaS Controller is already configured for SSL, so to enable your environment for SSL you only need to do the following:
- Configure your agents for SSL by enabling SSL and setting the port connection for the SaaS Controller to 443. See the following sections, App Agent Security and Machine Agent Security, for more information.
App Agent Security
To configure your agents for SSL, set these SSL-related properties:
- Set controller-ssl-enabled to true.
- Set the controller-port to the correct value for either on-premise or SaaS Controller.
In multi-tenant and SaaS environments, App Agents authenticate themselves to the Controller using the required account name and account access key values set in the connection properties configuration file.
Standalone Machine Agent Security
For information on the security settings related to the Standalone Machine Agent connection to the Controller, see Machine Agent Configuration Properties.
Verify the Connection
Follow these instructions to verify that the Java or .NET App Agent is reporting to the AppDynamics Controller.
Access the AppDynamics Controller UI:
For on-premise Controller installations, open a browser at:
For the SaaS Controller Service, open a browser at the URL provided to you by AppDynamics.
- Provide user credentials:
- For on-premise Controller installations, provide the credentials for the "admin" user as configured during AppDynamics Controller installation.
- For the SaaS Controller Service, use the credentials provided to you by AppDynamics.
- In the left navigation panel, click on an application.
- Click Servers -> App Servers -> <TierName>.
The Tier Dashboard for the selected tier appears.
- Click the Nodes tab.
When an App Agent is reporting to the Controller, the App Agent Status column shows a green up arrow icon.
If the agent is not reporting to the Controller, see the following troubleshooting information:
- Resolving Configuration Issues App Agent for Java
- Resolve App Agent for .NET Installation and Configuration Issues
Verify App Agent-Controller Communication
App Agent for Java Configuration Properties
App Agent for .NET Configuration Properties
Configure the App Agent for .NET
App Agent for PHP Proxy Configuration Properties
Install the App Agent for PHP using a Shell Script
Install the App Agent for PHP using RPM
Machine Agent Configuration Properties