Ruby Compatibility Requirements
Security Monitoring is now available Security Monitoring is now available

Ruby Compatibility Requirements

Compatibility

The Ruby Datadog Trace library is open source - view the Github repository for more information.

Supported Ruby interpreters:

TypeDocumentationVersionSupport typeGem version support
MRIhttps://www.ruby-lang.org/2.7FullLatest
2.6FullLatest
2.5FullLatest
2.4FullLatest
2.3FullLatest
2.2FullLatest
2.1FullLatest
2.0FullLatest
1.9.3Maintenance (until August 6th, 2020)< 0.27.0
1.9.1Maintenance (until August 6th, 2020)< 0.27.0
JRubyhttp://jruby.org/9.2.0.0AlphaLatest

Supported web servers:

TypeDocumentationVersionSupport type
Pumahttp://puma.io/2.16+ / 3.6+Full
Unicornhttps://bogomips.org/unicorn/4.8+ / 5.1+Full
Passengerhttps://www.phusionpassenger.com/5.0+Full

Supported tracing frameworks:

TypeDocumentationVersionGem version support
OpenTracinghttps://github.com/opentracing/opentracing-ruby0.4.1+ (w/ Ruby 2.1+)>= 0.16.0

Full support indicates Datadog supports all tracer features.

Deprecated indicates Datadog support will transition to Maintenance in a future release.

Maintenance indicates Datadog will only patch critical bugfixes.

EOL indicates Datadog is no longer providing support.

Integration instrumentation

Many popular libraries and frameworks are supported out-of-the-box, which can be auto-instrumented. Although they are not activated automatically, they can be easily activated and configured by using the Datadog.configure API:

Datadog.configure do |c|
  # Activates and configures an integration
  c.use :integration_name, options
end

options is a Hash of integration-specific configuration settings.

For a list of available integrations, and their configuration options, please refer to the following:

NameKeyVersions SupportedHow to configureGem source
Action Cableaction_cable>= 5.0LinkLink
Action Viewaction_view>= 3.0LinkLink
Active Model Serializersactive_model_serializers>= 0.9LinkLink
Action Packaction_pack>= 3.0LinkLink
Active Recordactive_record>= 3.0LinkLink
Active Supportactive_support>= 3.0LinkLink
AWSaws>= 2.0LinkLink
Concurrent Rubyconcurrent_ruby>= 0.9LinkLink
Dallidalli>= 2.0LinkLink
DelayedJobdelayed_job>= 4.1LinkLink
Elasticsearchelasticsearch>= 1.0LinkLink
Ethonethon>= 0.11LinkLink
Exconexcon>= 0.50LinkLink
Faradayfaraday>= 0.14LinkLink
Grapegrape>= 1.0LinkLink
GraphQLgraphql>= 1.7.9LinkLink
gRPCgrpc>= 1.7LinkLink
MongoDBmongo>= 2.1LinkLink
MySQL2mysql2>= 0.3.21LinkLink
Net/HTTPhttp(Any supported Ruby)LinkLink
Prestopresto>= 0.5.14LinkLink
Racecarracecar>= 0.3.5LinkLink
Rackrack>= 1.1LinkLink
Railsrails>= 3.0LinkLink
Rakerake>= 12.0LinkLink
Redisredis>= 3.2LinkLink
Resqueresque>= 1.0, < 2.0LinkLink
Rest Clientrest-client>= 1.8LinkLink
Sequelsequel>= 3.41LinkLink
Shoryukenshoryuken>= 3.2LinkLink
Sidekiqsidekiq>= 3.5.4LinkLink
Sinatrasinatra>= 1.4LinkLink
Sucker Punchsucker_punch>= 2.0LinkLink

Further Reading

Additional helpful documentation, links, and articles: