Install the Ruby agent on Heroku

Install the New Relic Ruby agent on Heroku using the New Relic add-on.

Prerequisites

Requirement	Details
New Relic account	A New Relic account is created automatically when you install the Heroku add-on.
Heroku account	A Heroku account with your Ruby app already deployed.
Ruby version	See Ruby agent requirements and supported frameworks for supported versions.

Run the following command, replacing $planlevel with the appropriate subscription plan:

bash

$heroku addons:create newrelic:$planlevel

Installing the add-on automatically creates a New Relic account and configures access for Heroku hosts.

Add the newrelic_rpm gem to your Gemfile:

gem 'newrelic_rpm'

Set your app name using the Heroku toolbelt:

bash

$heroku config:set NEW_RELIC_APP_NAME='Your Application Name'

The license key is set automatically by the add-on. For all other configuration options, see Ruby agent configuration.

Restart your dyno and generate some traffic to your app:

bash

$heroku restart

Wait 2–3 minutes and open one.newrelic.com > APM to look for your app by name.

App not appearing? See No data appears (Ruby).