Install the AppDynamics Site Extension for Java

• An Azure web app to monitor.

If you are upgrading from a previous version, see Upgrade the AppDynamics Azure Site Extension.

Add the AppDynamics Azure Site Extension

Add the AppDynamics Azure Site extension as you would any site extension for any Azure web app.

1. Log in to the Windows Azure Portal.

2. Browse to your web app. To configure the Java Agent using environment variables, add the environment variables before you install the AppDynamics Azure Site Extension. See Configure the agent using environment variables.

3. From the DEVELOPMENT TOOLS list, click Extensions.
4. Click +Add to install the version of the AppDynamics Java Agent you want to add to your web app.
   After you install the AppDynamics Azure Site Extension, it displays in the installed extensions list.

Configure the Controller Connection

There are two options to configure the Java Agent to connect to the AppDynamics Controller:

• Configure the Controller connection using the Kudu Console.
• Configure the Controller connection settings using environment variables.

See Agent-to-Controller Connections.

Configure the Agent with the Kudu Console

When you add the AppDynamics Azure Site Extension to your web app, you can interactively configure the Java Agent using the Kudu Console.

1. Navigate to the AppDynamics Controller Configuration page in the Kudu Console:
   http://{web app}.scm.azurewebsitesJava/appdynamics/
   For example: https://myazureexample.scm.azurewebsitesJava/appdynamics/
2. On the AppDynamics Controller Configuration page, enter your Controller connection information. For example:
   
3. Click Validate to test the connection to the AppDynamics Controller and save your settings.
4. Restart your web app. After you apply some load to your web app, you can view it on flow maps in the AppDynamics Controller UI.

Configure the Agent Using Environment Variables

Configuring the Java Agent using environment variables allows for unattended configuration. To configure agents, add the environment variables before you install the AppDynamics Azure Site Extension: 

1. Navigate to SETTINGS > Application Settings for your web app.
2. Add the Java Agent environment variables under App settings:
   
   • APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY: A unique key associated with the Controller account.
   • APPDYNAMICS_CONTROLLER_HOST_NAME: The hostname of the AppDynamics Controller.
   • APPDYNAMICS_CONTROLLER_SSL_ENABLED: Set it to True to enable SSL connection to the Controller. Otherwise set it to False.
   • APPDYNAMICS_AGENT_ACCOUNT_NAME: The account name you use to log on to the Controller.
   • APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY: The account key you use to log on the Controller.
   • APPDYNAMICS_AGENT_APPLICATION_NAME: The business application name in the Controller.
   • APPDYNAMICS_AGENT_TIER_NAME: The tier name in the Controller.
   • APPDYNAMICS_AGENT_NODE_NAME: The node name in the Controller.
3. Restart your web app. After you apply some load to your web app, you can view it on flow maps in the AppDynamics Controller UI.

Upgrade the AppDynamics Azure Site Extension

When you click the Extensions tab for your web app, the Microsoft Azure Portal displays the currently installed version of the AppDynamics Azure Site Extension. The Update Available column of the installed extensions list indicates if there is a more recent minor release of the Java Agent available. If so, you can click to update the extension from the list.

Upgrade a Major Version of the Java Agent

AppDynamics maintains major release versions of the Java Agent as separate site extensions. Therefore, you must uninstall the installed version of the AppDynamics Azure Site Extension before you upgrade to a new major release:

1. Log in to the Windows Azure Portal.
2. Stop your web app.
3. Click the AppDynamics Azure Site Extension from the list of installed extensions and click Delete to uninstall it.
4. Install the new version of the AppDynamics Azure Site Extension as normal.