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 monitoring in Pivotal Cloud Foundry (PCF).

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 secutiry configuration of the BOSH Director.

For an example, see the Security Page section of the Configuring Ops Manager Director on vSphere topic in the PCF documentation.

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

  -----BEGIN CERTIFICATE-----
ABCDEFGH12345678ABCDEFGH12345678ABCDEFGH12345678AB
EFGH12345678ABCDEFGH12345678ABCDEFGH12345678ABCDEF
GH12345678ABCDEFGH12345678ABCDEFGH12345678...
------END CERTIFICATE------
-----BEGIN CERTIFICATE-----
BCDEFGH12345678ABCDEFGH12345678ABCDEFGH12345678ABB
EFGH12345678ABCDEFGH12345678ABCDEFGH12345678ABCDEF
GH12345678ABCDEFGH12345678ABCDEFGH12345678...
------END CERTIFICATE------
-----BEGIN CERTIFICATE-----
CDEFGH12345678ABCDEFGH12345678ABCDEFGH12345678ABBB
EFGH12345678ABCDEFGH12345678ABCDEFGH12345678ABCDEF
GH12345678ABCDEFGH12345678ABCDEFGH12345678...
------END CERTIFICATE------

Set Up the AppDynamics Controller

Define an App and Tier in the Controller

  1. Log in to the Controller.

  2. Go to the Applications page. At the top of the table, click Create Application. Appd create app 01

  3. In the Create Application dialog box, click Create an Application manually, enter the app name, and click OK.
    Appd create app 02

  4. In the Application Dashboard for the new app, go to Tiers & Nodes.

  5. Click Actions at the top of the table and choose Create App Server Tier. Appd create app 03

  6. Select the app type and click Next. Appd create app 04

  7. Enter the tier name and description and click Finish. Appd create app 05

Note the Application Name and Tier Name before proceeding. You will need this information when you set up the Service Broker tile.

Determine the Tier ID

  1. In the Tiers & Nodes table for the application you just created, right-click on the tier and choose View.

  2. Examine the page URL and look for the component=<number> string. This number is the tier ID. Appd component id

Note the Tier ID before proceeding. You will need this information when you set up the Service Broker tile.

Set Permissions for AppDynamics User Account to Publish Dashboards

  1. In the AppDynamics Controller UI, navigate to Settings > Administration.

  2. Go to the Roles tab and create a role with a descriptive name such as “PCF KPI Role.”

  3. Go to the Applications sub-tab and do the following:

    1. Add the app you defined previously in Define an Application and Tier in the Controller.
    2. Under Custom Permissions for Applications/Tiers, add the app you defined previously.
    3. Check the View option for the app.
    4. Click the Edit link for the app. In Edit Permissions, select Configure Health Rules.
  4. Go to the Dashboards sub-tab and select Can Create Dashboards.

  5. Save the role.

  6. Go to the Users tab, select the user of interest, and add the role you just created.

Set Up the Service Broker 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 192.168.1.22 or myhost or myhost.example.com. 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.

AppDynamics Machine Agent Setup

  1. In the Settings tab, click AppDynamics Machine Agent Configuration.

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

    • 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 navigate to 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 192.168.1.22 or myhost or myhost.example.com. This is the same host that you use to access the AppDynamics browser-based user interface.
    • Controller Port – Port on which controller is listening (e.g: 8090).
    • SSL Enabled: Disabled by default. Enable this if you have SSL enabled on the controller. The controller port must be 443 if enabled.
    • Application Name, Tier Name, and Tier ID – Enter the application name, tier name, and tier ID you defined previously in Define an Application and Tier in the Controller.
    • Node Name – Enter a name that corresponds to the Application Name, such as app-name-node.
    • User Name – Must be an AppDynamics user account that has permissions to create both custom metric dashboards and custom Health Rules in the target application.
    • Password – Password for the above AppDynamics user account. Machine agent 2
  3. Click Save to save the changes and return to the Installation Dashboard.

AppDynamics Analytics Agent Setup

If you have an AppDynamics Analytics license, and want to and view transaction analytics on the AppDynamics controller, install the Analytics Agent as described in Configuring Transaction Analytics.

Apply All Updated Settings

  1. In the Installation Dashboard, click Apply Changes and wait for all the changes to get applied.
Create a pull request or raise an issue on the source for this page in GitHub