Skip to content

Latest commit

 

History

History
45 lines (37 loc) · 2.4 KB

framework-new-relic-agent.md

File metadata and controls

45 lines (37 loc) · 2.4 KB

New Relic Agent Framework

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

Detection CriterionExistence of a single New Relic service is defined as the VCAP_SERVICES payload containing at least one of the following:
  • name that has the substring newrelic. Note: This is only applicable to user-provided services
  • label that has the substring newrelic.
  • tags that have the substring newrelic.
Tagsnew-relic-<version>
Tags are printed to standard output by the Buildpack detect script.

User-Provided Service (Optional)

Users may optionally provide their own New Relic service. A user-provided New Relic service must have a name or tag with newrelic in it so that the New Relic 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
licenseKey The license key to use when authenticating

Configuration

The framework can be configured by modifying the config/newrelicagent.yml file in the buildpack fork.

Name Description
repository_root The URL of the New Relic repository index.
version The version of New Relic to use. Candidate versions can be found in this listing.

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/new_relic_agent directory in the buildpack fork. For example, to override the default newrelic.yml add your custom file to resources/new_relic_agent/newrelic.yml.