Before you install New Relic's Ruby agent, make sure you meet these requirements for compatible operating systems, security requirements, and supported frameworks.
If you don't have one already, start by creating a New Relic account. It's free, forever.
The Ruby agent supports UNIX-like operating systems such as Linux, Solaris, FreeBSD, and macOS.
As a standard security measure for data collection, your app server must support SHA-2 (256-bit). SHA-1 is not supported.
The New Relic Ruby agent does not support experimental versions. Ruby versions supported by the Ruby agent include:
Web servers supported by the Ruby agent include:
Supported for all agent-supported versions of Ruby
The Ruby agent does not support experimental versions. Web frameworks supported by the Ruby agent are listed below. Please note that Grape, Padrino, and Sinatra are not supported for Ruby 3.0+.
The Ruby agent does not support experimental versions. Databases supported by the Ruby agent include:
If your application uses other application performance monitoring (APM) software besides our agent, we cannot guarantee that our agent will work correctly and we cannot offer technical support. For more information, see Errors when using other monitoring software.
New Relic collects instance details for a variety of databases and database drivers. The ability to view specific instances and the types of database information in APM depends on your New Relic agent version.
New Relic's Ruby agent version 3.17.0 or higher supports the following ORM databases:
Minimum agent version
ActiveRecord 5 or higher
ActiveRecord 2.1 to 4
The Ruby agent also supports these
Minimum gem version
Minimum agent version
To request instance-level information from datastores currently not listed for your New Relic agent, get support at support.newrelic.com.
Background jobs supported by the New Relic Ruby agent include:
HTTP clients supported by the Ruby agent include:
- Net::HTTP: Supported for all agent-supported versions of Ruby.
- Curb: 0.8.1 or higher
- Excon: 0.10.1 or higher
- HttpClient: 2.2.0 or higher
- HttpRb: 0.9.9 or higher
- Typhoeus: 0.5.3 or higher
APM's Ruby agent also supports:
- ActiveMerchant:1.25.0 or higher
- Bunny: 2.0 or higher
- Yajl-Ruby:1.1.0 or higher
The Ruby agent integrates with other New Relic capabilities to give you end-to-end visibility.
When you install the Infrastructure and APM agents on the same host, they automatically detect one another. You can then view a list of hosts in the APM UI, and filter your Infrastructure hosts by APM app in the Infrastructure UI. For more information, see APM data in infrastructure monitoring.
Synthetic transaction traces connect requests from Synthetics monitors to the underlying APM transaction.
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's data security and licenses documentation.