Upgrade Ruby agent versions

End of life notification: As of January 26, 2015, New Relic will no longer accept data from Ruby agent versions prior to 3.5.3.

These agent versions use an out-of-date protocol when communicating with New Relic's data collection services, and many also contain a potential security issue where they may incorrectly send sensitive data to New Relic's servers.

To take the fullest advantage of New Relic's latest features, enhancements, and important security patches, New Relic strongly recommends that you update your Ruby agent to the latest version. For more information about agent updates, refer to the Ruby agent release notes.

Verify your Ruby agent version

To verify which Ruby agent version your apps currently use:

  1. From the New Relic UI, select (account dropdown) > Account settings > Connected agents.
  2. Optional: Sort by Oldest agent version.
  3. Look for Ruby apps that are earlier than version 3.5.3.

Update the Ruby agent

To verify the current Ruby agent version available:

  1. From the New Relic UI, select (account dropdown) > Account settings.
  2. From the Account information section, review the latest Ruby agent version.
  3. Select the link to the update instructions.

In general, to update to the latest Ruby agent version:

  • If you use bundler to manage your application's dependencies, then run:

    bundle update newrelic_rpm
  • If you do not use bundler, then run:

    sudo gem update newrelic_rpm

Instrument JRuby

For correct instrumentation of New Relic on JRuby, use:

Otherwise, if your application has no transactions and you are using JRuby, you will not be able to see your CPU metrics. 

This was due to a bug in JRuby, where Process.times returned wall clock time instead of elapsed CPU time. That bug was fixed as of New Relic’s Ruby agent 3.6.8.164 and JRuby 1.7.0.

For more help

Additional documentation resources include:

  • New Relic for Ruby (overview including compatibility and requirements, installation, configuration, troubleshooting, and known issues)
  • Ruby agent installation (Ruby gems, configuration file, and procedures to install, update, and uninstall)

Join the discussion about Ruby in the New Relic Online Technical Community! The Technical Community is a public platform to discuss and troubleshoot your New Relic toolset.

If you need additional help, get support at support.newrelic.com.