framework-app_dynamics_agent.md

AppDynamics Agent Framework

The AppDynamics Agent Framework causes an application to be automatically configured to work with a bound AppDynamics Service.

Detection Criterion	Existence of a single bound AppDynamics service. The existence of an AppDynamics service defined by the VCAP_SERVICES payload containing a service name, label or tag with app-dynamics as a substring.
Tags	app-dynamics-agent=<version>

Tags are printed to standard output by the buildpack detect script

User-Provided Service

When binding AppDynamics using a user-provided service, it must have name or tag with app-dynamics in it. The credential payload can contain the following entries:

Name	Description
account-access-key	(Optional) The account access key to use when authenticating with the controller
account-name	(Optional) The account name to use when authenticating with the controller
host-name	The controller host name
port	(Optional) The controller port
ssl-enabled	(Optional) Whether or not to use an SSL connection to the controller

Configuration

For general information on configuring the buildpack, refer to Configuration and Extension.

The framework can be configured by modifying the config/app_dynamics_agent.yml file. The framework uses the Repository utility support and so it supports the version syntax defined there.

Name	Description
repository_root	The URL of the AppDynamics repository index (details).
version	The version of AppDynamics to use. Candidate versions can be found in this listing.