Skip to content

Latest commit

 

History

History
83 lines (66 loc) · 3.86 KB

framework-dynatrace-agent.md

File metadata and controls

83 lines (66 loc) · 3.86 KB

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).

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.
  • The DynaTrace agent can also be configured to exclude certain classes by specifying an exclude parameter in the service options in VCAP_SERVICES, which may help with performance issues.
Detection CriterionExistence 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 credentials 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/dynatraceagent.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.3.0.

Additional Configuration

This buildpack supports adding additional DynaTrace Agent configuration options to the bound service through an options payload in the service. The options payload should be a collection of name-value pairs similar to the following:

"options" : {
    "dynatrace-parameter": "value",
    "another-parameter": "value"
}

Supported parameters are any parameters which the DynaTrace agent supports