New Relic for Ruby

The Ruby agent as New Relic's flagship release is our most mature, feature-laden product. For information about getting started with the Ruby agent, start here.

Compatibility and requirements

For full information on the Ruby agent's compatibility with various platforms and frameworks, see Supported frameworks.

Compatibility for... Requirements
Ruby 1.8.7 (including REE), 1.9.2, 1.9.3, 2.0.0, and 2.1.0; JRuby 1.6 and above; Rubinius 2.x
  • UNIX-like operating systems such as Linux, Solaris, Mac OS X
  • Limited support for Windows XP or later
Frameworks Rails versions 2.1 to 4.x, Sinatra, Rack, Resque, Sidekiq, and many more
Dispatchers Nearly any Ruby web servers including Thin, Passenger, Unicorn, Puma, Glassfish, Rainbows, etc.


Before you can install the Ruby agent, you must have a New Relic account. The Ruby agent is available as a gem and also as a Rails plugin. New Relic highly recommends installing the gem. For more information, see:

Note: As part of the installation process, change the default application name to a meaningful name.


After installing the Ruby agent, follow the Ruby agent configuration procedures.


After sending a request to your web application, data should appear in the New Relic console within 2-3 minutes. If no data appears after a few minutes, follow these troubleshooting steps.

Note: It's usually not enough to touch the Passenger tmp/restart.txt file. You need to do a hard restart of Apache for the change to take effect.

  1. Restart the web server.
  2. Check the New Relic agent is running. For more information, see Controlling when the Ruby agent starts.
  3. Check the New Relic agent log for errors. If nothing is obvious at the info level, edit your newrelic.yml file to increase your log_level to debug, and then restart your web server. Capture at least 5-10 minutes of log time.
  4. Check the New Relic agent log for an entry that has INFO : Reporting to: followed by a URL. Ensure that URL matches the account and application you are viewing in the New Relic UI.

Known issues

For more information about known issues with the Ruby agent, see Incompatible gems.

For more help

Additional documentation resources include:

If you need additional help, get support at