You can use the Windows Azure Portal to add the AppDynamics Azure Site Extension to your Azure App Service web app. Azure Site Extension is used by Ops teams that may not have access to source files, or would not like to modify or recompile them, yet still want to monitor their Azure projects and solutions.

Prepare to Install

To install the AppDynamics for Windows Azure Site Extension, you need the following:

  • 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. 
    If you want 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 appears in the list of the installed extensions.

Configure the Controller Connection

You have the following options to configure the Java Agent to connect to the AppDynamics Controller:

For more detail, 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 in this manner, add the environment variables before you install the AppDynamics Azure Site Extension, as follows: 

  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 on 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 need to 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 on 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.

 
 

 
  • No labels