Update the Ruby agent

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

Determine your Ruby agent versions

To determine which Ruby agent versions your apps currently use:

  1. From the account dropdown in the New Relic UI, select Account settings > Connected agents.
  2. Optional: Sort by Oldest agent version.

Update the agent

To update the agent:

  • Using Bundler: Run this command:

    bundle update newrelic_rpm
  • Not using Bundler: Run this command:

    gem update newrelic_rpm

Instrument JRuby

For correct instrumentation:

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.

Ruby versions not supported

End of life notification: As of January 26, 2015, New Relic will no longer accept data from Ruby agent versions earlier than 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 the New Relic collector.

Ruby versions 3.18 or lower

With the release of Ruby agent version 4.0.0, some deprecated APIs were deleted. If you have used any of the deprecated methods with a version of Ruby agent 3.18 or lower, update your API with the recommended replacements.

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)

Recommendations for learning more: