framework-dyna_trace_agent.md

DynaTrace Agent Framework

The DynaTrace Agent Framework causes an application to be automatically configured to work with a bound DynaTrace Service instance (Free trials available).

The applications Cloud Foundry name is used as the agent group in DynaTrace, and must be pre-configured on the DynaTrace server.

NOTE

• The DynaTrace agent slows down app execution significantly at first, but gets faster over time. Setting the application manifest to contain maximum_health_check_timeout of 180 or more and/or using cf push -t 180 or more when pushing a DynaTrace-monitored application may help.
• Multiple cf pushs will cause dead penguins to build up in the DynaTrace agent dashboard, as CF launches/disposes application containers. These can be hidden but will collect in the dynatrace database.

Detection Criterion	Existence of a single bound DynaTrace service. Existence of a DynaTrace service is defined as the VCAP_SERVICES payload containing a service who's name, label or tag has dynatrace as a substring.
Tags	dyna-trace-agent=<version>

Tags are printed to standard output by the buildpack detect script

User-Provided Service

Users must provide their own DynaTrace service. A user-provided DynaTrace service must have a name or tag with dynatrace in it so that the DynaTrace Agent Framework will automatically configure the application to work with the service.

The credential payload of the service may contain the following entries:

Name	Description
server	The DynaTrace collector hostname to connect to. Use host:port format for a specific port number.
profile	(Optional) The DynaTrace server profile this is associated with. Uses Monitoring by default.

NOTE

Be sure to open an Application Security Group to your DynaTrace collector prior to starting the application:

$ cat security.json
   [
     {
       "protocol": "tcp",
       "destination": "dynatrace_host",
       "ports": "9998"
     }
   ]

$ cf create-security-group dynatrace_group ./security.json
Creating security group dynatrace_group as admin
OK

$ cf bind-running-security-group dynatrace_group
Binding security group dynatrace_group to defaults for running as admin
OK

TIP: Changes will not apply to existing running applications until they are restarted.

Configuration

For general information on configuring the buildpack, including how to specify configuration values through environment variables, refer to Configuration and Extension.

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

Name	Description
repository_root	The URL of the DynaTrace repository index (details).
version	The version of DynaTrace to use. This buildpack framework has been tested on 6.1.0.
default_agent_name	This is omitted by default but can be added to set the DynaTrace agent name. If it is not specified then #{application_name}_#{profile_name} is used, where application_name is defined by Cloud Foundry.

Additional Resources

The framework can also be configured by overlaying a set of resources on the default distribution. To do this, add files to the resources/dyna_trace_agent directory in the buildpack fork.