• An Azure web app to monitor.

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

Add the Cisco AppDynamics Azure Site Extension

Add the 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 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 Cisco AppDynamics Java Agent you want to add to your web app.
   After you install the 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 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 Azure Site Extension to your web app, you can interactively configure the Java Agent using the Kudu Console.

1. Navigate to the Controller Configuration page in the Kudu Console:
   http://{web app}.scm.azurewebsitesJava/appdynamics/
   For example: https://myazureexample.scm.azurewebsitesJava/appdynamics/
2. On the Controller Configuration page, enter your Controller connection information. For example:
   • Controller Host: mycompany.saas.appdynamics.com
   • Port: 443
   • Select Enable SSL
   • Account Name: MyAccount
   • Access Key: <your access key from the Controller UI>
   • Application Name: MyAzureApp
3. Click Validate to test the connection to the 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 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 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 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 Controller UI.

Upgrade the Cisco 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 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

maintains major release versions of the Java Agent as separate site extensions. Therefore, you must uninstall the installed version of the 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 Cisco AppDynamics Azure Site Extension from the list of installed extensions and click Delete to uninstall it.
4. Install the new version of the Azure Site Extension as normal.