Bind a Custom New Relic Instance to a Ruby App on PWS

Products

• Services Suite

Issue/Introduction

This article describes how to bind a custom New Relic instance to a Ruby app on the Pivotal Web Services (PWS).

Pivotal recommends the use of marketplace services from PWS marketplace. However, this is just for the convenience of the customers and there are circumstances when it's entirely appropriate to use a New Relic key obtained through a different way.

Resolution

Follow the steps mentioned below to connect a custom New Relic instance (not from PWS marketplace) to a sample rails app:

• Obtain a New Relic instance credentials from the vendor.

• Fork the following application from Github:
  https://github.com/cloudfoundry-samples/rails_sample_app.
  This is an example. You can substitute the actual Rails application here instead.

• Modify the following file:
  https://github.com/cloudfoundry-samples/rails_sample_app/blob/newrelic/config/newrelic.yml#L19
  and supply appropriate New Relic instance credentials.

Use the New Relic and other service offerings from PWS marketplace as they provide auto-binding without the need to manually supply the credentials.

Be careful when injecting your service credentials directly into a configuration file that is part of your application. You do not want the service credentials to be checked into source code as this could leak the configuration values.