AppDynamics Platform Metrics for PCF FAQs

General FAQs

What is included in the AppDynamics Platform Metrics for PCF tile?

  • AppDynamics PCF FireHose Nozzle Agent. The Agent collects PCF metrics through a custom Nozzle from Loggregator.
  • AppDynamics PCF Dashboard. This is an auto-generated custom dashboard that creates health rules for the above PCF metrics and presents it on the Controller.

How do I configure SSL (On-Prem Controller deployment)?

  • Include the entire certificate chain in the security configuration of the BOSH Director tile. This ensures that the BOSH deployments and Diego cells have automatic access to the certificates while validating the SSL connection.
  • AppDynamics deployments automatically reads the certificates and imports them into the correct key stores. No additional steps are required.
  • Use the exact format (no comments) as specified in the Pivotal Ops Manager documentation.
  • Select all the SSL check boxes in the Tile Configuration Forms.

How do I configure SSL (SAAS deployment)?

  • AppDynamics SAAS Controllers are signed with standard DigiCerts CA. They are already included in the BOSH deployments and application containers.
  • Select all the SSL check boxes in the Tile Configuration Forms.

My installation failed, what do I provide to the AppDynamics support?

  • Collect the error logs from the Ops Manager installation page and provide the entire deployment log files to the AppDynamics support.

AppDynamics Platform Metrics for PCF FAQs

What is PCF Dashboard?

  • The PCF Dashboard Generator is a Python 3 application that generates a platform dashboard and set of health rules for the PCF foundations that have installed the AppDynamics tile v4.5.x. The generated dashboard and health rules leverage the custom metrics published by the AppDynamics tile to the Controller and application configured in the AppDynamics tile.

Where do I find this Dashboard?

  • The dashboard can be found in the Dashboards and Reports page of the AppDynamics Controller, with a name {appname}-{tiername}-PCF KPI Dashboard where appname and tiername are the names of Nozzle Agent and tier name you have configured in the tile.

How is this Dashboard created?

  • The Dashboard application reads the KPI metrics emitted by the Nozzle Agent in the tile and associates them with various auto-generated health rules and renders a neat custom dashboard.

I do not see this dashboard, how do I troubleshoot?

  • Ensure that the application is deployed properly. You should see appdpcfdashboard-version running if the application is successfully deployed.
      $ cf target -o appdynamics-org -s appdynamics-space
      $ cf apps
          Getting apps in org appdynamics-org / space appdynamics-space as admin...
      name                       requested state   instances   memory   disk   urls
      appdpcfdashboard-4.4.337   started           1/1         128M     1G      appdpcfdashboard.cfapps.pie-20.cfplatformeng.com

Where do I find the logs?

  • Run cf logs appdpcfdashboard-{version} in appdynamics-org and appdynamics-space.

Can I redirect the logs?

  • To redirect the logs to use STDERR, use the Overriding Default Nozzle Configuration environment variable APPD_DEBUG. Setting it to true will direct AppDynamics Agent logs to STDERR instead of log files.

        $ cf set-env appdnozzle-4.5.489 APPD_DEBUG true`.
        $ cf restage appdnozzle-4.5.489
    

    How do I troubleshoot an SSL issue?

  • Run $ cf ssh appdpcfdashboard-{version}

  • Make sure that the correct certificate is present in the /home/vcap/app/cert.pem file of the application.

    Run cat /home/vcap/app/cert.pem

How do I change a configuration variable?

  • The application is configured by using environment variables. To override, run $ cf set-env appdpcfdashboard-{version} {ENVNAME} {ENVVAR}
  • The list of environment varibles can be found by running $ cf env appdpcfdashboard-{version}

How do I troubleshoot a tile install?

  • It’s not uncommon that in production environments cf ssh access is not allowed. In this case, under Settings/User Provided Environment Variables, set APPD_DEBUG to true for the appdnozzle app in the Apps Manager, or use the cf set-env command and restart the app. This setting forwards the agent logs to STDOUT, so you’ll be able to view them in the Apps Manager or using cf logs APP_NAME.
Create a pull request or raise an issue on the source for this page in GitHub