AppDynamics Application Intelligence Platform

3.9.x Documentation


Learn by Watching

Doc Maps

Skip to end of metadata
Go to start of metadata

Use these instructions to install the Java Agent using the Agent Download Wizard in the Controller.

If you downloaded the agent from the AppDynamics download zone, see Install the Java Agent.

Before You Begin

1. Confirm you have access to a Controller, the web application where you monitor your application performance:

    • If you use a SaaS controller, AppDynamics sent you the Controller host location in your Welcome Email.
    • If you use an on-premise Controller, you configured the host and port at install time.

2. Identify the startup script for you the JVM for your application. To enable the agent, you edit the startup script.


Instrumenting Your JVM with the Java Agent

There are four steps to instrument your JVM and begin monitoring:

1. Download: Use the Agent Download Wizard to configure and download the agent.
2. Install: Unzip the agent on your server and add it to your JVM startup script.
3. Apply Load: Restart your application and apply load to activate instrumentation.
4. View Your Application: Log on to the Controller to monitor application performance.

Download the Java Agent

The Agent Download Wizard walks you through configuration steps and helps you download the agent.

1. Log on to the Controller and click the Agent Download Wizard tab.

The download wizard configures the agent with information to connect to the Controller.


2. Click Java, then click Next.


3. Click to Select JVM, then click Next.


4. The Controller Location URL window displays the connection info for the Controller. Click Next.

Click SSL to enable SSL encryption between the agent and the Controller. Enter the SSL port. For AppDynamics SaaS, the SSL port is 443.


5. Enter an application name or, click an existing application name if one exists. Then click Next.

For new users, it is OK to use the default MyApp. You can change it later when know more about how you want to organize your applications in AppDynamics.


6. Enter a tier name. Then click Next.

For new users, it is OK to use the default MyTier. You can change it later when know more about how you want to organize your applications in AppDynamics.


7. Click Click here to Download to download the Java Agent.



Now you're ready to install the agent on your app server.


Install the Agent on the App Server

After you download the agent, install it to your app server. The final window of the Agent Download Wizard includes brief instructions for installing the agent.

1. Log on as an administrator to the machine running your Java application. Unzip the file.


For example, on Linux unzip the agent to home/appdynamics. This is the <agent home> directory.

unzip -d /opt/appdynamics/appagent

2. Edit your startup configuration file to include the Java Agent.

Now you're ready to restart your application and put some load on it.

Apply load to your application

  1. Restart the JVM.
  2. Apply load to your application.

The agent instruments the application code and reports metrics back to the Controller. You're ready to begin monitoring.

View your application

Log on to the Controller to see your application in action.

From here, you can install more agents or you can begin monitoring your application. The links below will help you get started:



Learn More