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 the Supported Frameworks article.
|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|
|OS||UNIX-like operating systems such as Linux, Solaris, Mac OS X. Limited support of 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|
To use the Ruby agent, you first need to have a New Relic account. Get sign-up instructions here.
The Ruby agent is available as a gem and also as a Rails plugin. New Relic highly recommends installing the gem.
Note: As part of the installation process, change the default application name to a meaningful name.
Full descriptions of configuration for the Ruby agent can be found in the configuration article
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:
tmp/restart.txtfile. You need to do a hard restart of Apache for the change to take effect.)
infolevel, edit your
newrelic.ymlfile to increase your
debugand then re-start your web server again. Capture at least 5-10 minutes of log time, as if you continue to have problems we will specifically ask you for this file ("5-10 minutes of log time at
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.
For advanced features and configuration topics, see the following documents and resources.
If you still have problems after referring to the documentation resources listed above, submit a support ticket (for fastest service) or email support @ New Relic. Also, you may be able to find support from the community at Stack Overflow. Tag your post with