framework-dynatrace_one_agent.md

Dynatrace SaaS/Managed OneAgent Framework

Dynatrace SaaS/Managed is your full stack monitoring solution - powered by artificial intelligence. Dynatrace SaaS/Managed allows you insights into all application requests from the users click in the browser down to the database statement and code-level.

The Dynatrace SaaS/Managed OneAgent Framework causes an application to be automatically configured to work with a bound Dynatrace SaaS/Managed Service instance (Free trials available).

Detection Criterion	Existence of a single bound Dynatrace SaaS/Managed service. Existence of a Dynatrace SaaS/Managed service is defined as the VCAP_SERVICES payload containing a service who's name, label or tag has dynatrace as a substring with at least `environmentid` and `apitoken` set as credentials.
Tags	dynatrace-one-agent=<version>

Tags are printed to standard output by the buildpack detect script

User-Provided Service

Users must provide their own Dynatrace SaaS/Managed service. A user-provided Dynatrace SaaS/Managed service must have a name or tag with dynatrace in it so that the Dynatrace Saas/Managed OneAgent Framework will automatically configure the application to work with the service.

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

Name	Description
apitoken	The token for integrating your Dynatrace environment with Cloud Foundry. You can find it in the deploy Dynatrace section within your environment.
apiurl	(Optional) The base URL of the Dynatrace API. If you are using Dynatrace Managed you will need to set this property to https://<your-managed-server-url>/e/<environmentId>/api. If you are using Dynatrace SaaS you don't need to set this property.
environmentid	Your Dynatrace environment ID is the unique identifier of your Dynatrace environment. You can find it in the deploy Dynatrace section within your environment.
skiperrors	(Optional) The errors during agent download are skipped and the injection is disabled. Use this option at your own risk. Possible values are 'true' and 'false'. This option is disabled by default!

Configuration

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

Support

This buildpack extension is currently Beta. If you have any questions or problems regarding the build pack itself please don't hesitate to contact Dynatrace on https://answers.ruxit.com/, be sure to use "cloudfoundry" as a topic.