Installing and Configuring AppDynamics

Note: For instructions for installing AppDynamics v1.x, see (Deprecated) Installing and Configuring AppDynamics APM (1.x version).

This topic describes how to install and configure AppDynamics APM for Pivotal Cloud Foundry (PCF).

Note: Starting with v4.5.545, AppDynamics Analytics Support has been moved to a separate tile on Pivotal Network. If you want to use Transactional Analytics, install AppDynamics Analytics for PCF.


The diagram illustrates the results of installing the tile. An AppDynamics service broker is deployed as a PCF application to the org and space appdynamics-org/appdynamics-space. Each controller configured in the tile is published to the AppDynamics marketplace service as a unique plan, which apps can bind to.

In addition, the tile publishes the AppDynamics extension buildpack, appdbuildpack, which supports multiple buildpack workflows . Create a Pivotal Network account if you do not have one.

Pcf foundation 01

Before You Start

Create a Pivotal Network account if you do not have one.

Configuring SSL

If you are planning to use SSL, do the following based on the Controller type.

SSL for SaaS AppDynamics Controllers

AppDynamics SaaS controller use DigiCert Global Root CA. The tile automatically imports the DigiCert Global Root CA into the keystore used by AppDynamics Machine Agent and the dashboard app, if present.

Enable the SSL checkbox in AppDynamics Machine Agent configuration.

SSL for OnPremise AppDynamics Controllers

For OnPremise Controller deployments, upload the root certificate for the internal CA that signed the Controller certificate for your OnPremise Controller in the security configuration of the BOSH Director.

For an example, see Security Page in the PCF documentation.

Make sure to follow the exact format below while entering multiple certificates.


Setup the APM Tile

  1. Log in to Ops Manager.

  2. If the AppDynamics Service Broker tile does not appear in the Installation Dashboard, click Import a Product in the left-side menu and import the AppDynamics tile.

  3. Double-click the AppDynamics tile in the Installation Dashboard.

AppDynamics Controller Setup

  1. In the Settings tab, click AppDynamics Controller Configuration. Then click Add. Install 02 appd controller config add

  2. Enter the following Service Plan options. All of these fields are required.

    • Controller Configuration Name – A user-friendly name for this configuration profile. This name should include the Controller to which the Standalone Machine Agent reports.
    • Controller Configuration Description – A more complete description of this configuration profile.
    • Account Name – The account name used to access the Controller. You must specify an account with a valid App Agent license. To check this, do the following:
      • In the Controller, click the gear icon (top right) and choose License > Account > License.
      • In the Account Usage tab, under APM Usage, verify that the account has at least one available license unit for the type of application you are monitoring (Java, .NET, etc.).
    • Account Access Key – The account access key used to authenticate with the Controller. In the Controller, click the gear icon (top right) and choose License > Account > Access Key.
    • Controller Host – The host name or the IP address of the AppDynamics Controller. Example values are or myhost or This is the same host that you use to access the AppDynamics browser-based user interface. For an on-premises Controller, use the value for Application Server Host Name that was configured when the Controller was installed. If you are using the AppDynamics SaaS Controller service, see the welcome email from AppDynamics.
    • Controller Port – The HTTP (unencrypted) port used to access the AppDynamics Controller web interface. Defaults are 8090 (on-premise Controllers) and 80 (SaaS Controllers).
    • SSL Port – The HTTPS (encrypted) port used to access the AppDynamics Controller web interface. Defaults are 8181 (on-premise Controllers) and 443 (SaaS Controllers). Install 03 controller config options
  3. You can add multiple controller configurations by repeating steps 4 and 5. This will enable applications to bind to any of the entered configurations.

  4. Click Save to save the changes and return to the Installation Dashboard.

Validating the Install

Once the tile install completes successfully in the Ops Manager, you can confirm that the Controller plans have been successfully installed using cf marketplace:

$ cf marketplace -s appdynamics
service plan description free or paid
my-controller1 controller1 free

Confirm that the AppDynamics extension buildpack is available by using cf buildpacks:

$ cf buildpacks
buildpack position enabled locked filename
appdbuildpack 24 true false
Create a pull request or raise an issue on the source for this page in GitHub