Ruby agent requirements and supported frameworks

JRuby

• 9.0.x
• 9.1.x
• 9.2.x
• 9.3.x

• 1.7.x or earlier: Last supported agent was 3.18.1.330.

CRuby

• 1.8.7
• 1.9.x
• 2.0.x
• 2.1.x
• 2.2.x
• 2.3.x
• 2.4.x
• 2.5.x
• 2.6.x
• 2.7.x
• 3.0.x
• 3.1.x
• 3.2.x

• 2.2.x, 2.3.x Last supported agent: 8.16.0.
• 2.0.x, 2.1.x Last supported agent: 6.15.0.
• 1.8.7, 1.9.2, 1.9.3: Last supported agent was 3.18.1.330.
• 1.8.6: Last supported agent was 3.6.8.168.

Passenger

• 2.2.x
• 3.0.x
• 4.0.x
• 5.x.x
• 6.0.x

• 2.2.x, 3.0.x, 4.0.x: Last supported in agent version 8.16.0

Puma

• 2.0.x
• 3.x.x
• 4.x.x
• 5.x.x
• 6.x.x

• 1.0.x, 2.0.x: Last supported in agent version 8.16.0

Rainbows!

• 4.5.0

4.5.0: Last supported agent was 8.16.0.

Thin

• 1.x.x

Unicorn

• 4.x.x
• 5.x.x
• 6.0.x

• 1.0.x
• 2.0.x
• 3.0.x

Webrick

Supported for all agent-supported versions of Ruby

Grape

• 0.2.0
• 0.19.2
• 1.2.x
• 1.3.x
• 1.4.x
• 1.5.x
• 1.6.x
• 1.7.x

• 0.2.0: Last supported in agent version 8.16.0

Padrino

• 0.14.x
• 0.15.1
• 0.15.2

• 0.14.x: Last supported in agent version 8.16.0

Rack

• 1.6.x
• 2.x
• 3.0.x

• 1.0.x

Rails

• 3.2.x
• 4.0.x
• 4.1.x
• 4.2.x
• 5.0.x
• 5.1.x
• 5.2.x
• 6.0.x
• 6.1.x
• 7.0.x
• 7.1.x
• 7.2.x
• 8.0.x

• 2.1.x, 2.2.x, 2.3.x: Last supported agent was 3.18.1.330.
• 2.0.x: Last supported agent was 3.6.8.168.
• 3.0.x, 3.1.x: Last supported agent was 6.15.0.
• 3.2.x: Last supported agent was 8.16.0.

Roda

• 3.19.0 and higher

Sinatra

• 1.4.x
• 1.5.x
• 2.0.x
• 2.1.x
• 3.0.x

• 1.2.x, 1.3.x: Last supported agent was 6.15.0
• 1.4.x, 1.5.x: Last supported agent was 8.16.0

Active Record

• 3.2.x
• 4.0.x
• 4.1.x
• 4.2.x
• 5.0.x
• 5.1.x
• 5.2.x
• 6.0.x
• 6.1.x
• 7.0.x
• 7.1.x
• 7.2.x
• 8.0.x

• 3.2.x: Last supported in agent version 8.16.0.
• 3.0.x, 3.1.x: Last supported in agent version 6.15.0.
• 2.1.x, 2.2.x, 2.3.x: Last supported agent was 3.18.1.330.
• 2.0.x Last supported agent was 3.6.8.168.

DataMapper

• 1.0

• 1.0.x: Last supported agent: 8.16.0.

Elasticsearch

• 7.x
• 8.x

OpenSearch

• 2.x
• 3.x

Mongo

• 1.8.x
• 1.9.x
• 2.0.x
• 2.1.x
• 2.2.x
• 2.3.x
• 2.4.x or higher

• 1.8.x - 2.3.x: Last supported in agent version 8.16.0

Redis

• 3.x
• 4.0.x
• 4.1.x
• 4.2.x
• 5.0.x

Sequel

• 3.37.x
• 4.0.x
• 4.45.x or higher
• 5.x.x

• 3.37, 4.0.x: Last supported in agent version 8.16.0

PostgreSQL

pg

3.17.0

MySQL

mysql2

3.17.0

MySQL

Trilogy

9.16.1

Memcached

• Dalli
• memcached
• memcache-client

• 2.7.6
• 1.8.0
• 1.5.0

3.17.0

Mongo DB

mongo

1.8.6

3.17.0

Redis

redis-rb

3.0.7

3.17.0

Delayed_Job

• 2.0.x
• 3.0.x
• 4.0.x
• 4.1.x

• 2.0.x, 3.0.x, 4.0.x: Last supported in agent version 8.16.0

Rake

• 12.3.3 or higher
• 13.x

• 10.x
• 11.x
• 12.3.2 or earlier. NOTE: Only 12.3.3 or higher tested due to exploit potential in earlier versions.

Resque

• 1.23.x
• 1.27.x
• 2.0.0 or higher

• 1.22.x and earlier

Sidekiq

• 4.2.x
• 5.x
• 6.x
• 7.0.x

• 2.8.x, 3.4.x, 4.0.x, and 4.1.x: Last supported in agent version 6.15.0
• 4.2.x: Last supported in agent version 8.16.0

AI monitoring

You can collect AI data using the Ruby agent and the ruby-openai gem. This feature was introduced in Ruby agent version 9.8.0 and supports ruby-openai versions 3.4.0 and above.

Browser monitoring

The Ruby agent automatically injects the browser JavaScript agent when you enable auto-instrumentation. After enabling browser injection, you can view browser monitoring data in the APM Summary page and quickly switch between the APM and browser data for a particular app. For configuration options and manual instrumentation, see the browser and Ruby agent documentation.

Infrastructure monitoring

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 hosts by APM app in the infrastructure UI. For more information, see APM data in the infrastructure UI.

Synthetic monitoring

Synthetic transaction traces connect requests from synthetic monitors to the underlying APM transaction.