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.
For full information on the Ruby agent's compatibility with various platforms and frameworks, see Supported frameworks.
|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|
|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.
infolevel, edit your
newrelic.ymlfile to increase your
debug, and then restart your web server. Capture at least 5-10 minutes of log time.
INFO : Reporting to:followed by a URL. Ensure that URL matches the account and application you are viewing in the New Relic UI.
For more information about known issues with the Ruby agent, see Incompatible gems.
Additional documentation resources include:
If you need additional help, get support at support.newrelic.com.