Ruby Compatibility Requirements
Incident Management is now generally available! Incident Management is now generally 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
JRubyhttps://www.jruby.org9.2FullLatest

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 Supported: MRIVersions Supported: JRubyHow to configureGem source
Action Cableaction_cable>= 5.0>= 5.0LinkLink
Action Viewaction_view>= 3.0>= 3.0LinkLink
Active Model Serializersactive_model_serializers>= 0.9>= 0.9LinkLink
Action Packaction_pack>= 3.0>= 3.0LinkLink
Active Recordactive_record>= 3.0>= 3.0LinkLink
Active Supportactive_support>= 3.0>= 3.0LinkLink
AWSaws>= 2.0>= 2.0LinkLink
Concurrent Rubyconcurrent_ruby>= 0.9>= 0.9LinkLink
Dallidalli>= 2.0>= 2.0LinkLink
DelayedJobdelayed_job>= 4.1>= 4.1LinkLink
Elasticsearchelasticsearch>= 1.0>= 1.0LinkLink
Ethonethon>= 0.11>= 0.11LinkLink
Exconexcon>= 0.50>= 0.50LinkLink
Faradayfaraday>= 0.14>= 0.14LinkLink
Grapegrape>= 1.0>= 1.0LinkLink
GraphQLgraphql>= 1.7.9>= 1.7.9LinkLink
gRPCgrpc>= 1.7gem not availableLinkLink
http.rbhttprb>= 2.0>= 2.0LinkLink
Kafkaruby-kafka>= 0.7.10>= 0.7.10LinkLink
MongoDBmongo>= 2.1>= 2.1LinkLink
MySQL2mysql2>= 0.3.21gem not availableLinkLink
Net/HTTPhttp(Any supported Ruby)(Any supported Ruby)LinkLink
Prestopresto>= 0.5.14>= 0.5.14LinkLink
Racecarracecar>= 0.3.5>= 0.3.5LinkLink
Rackrack>= 1.1>= 1.1LinkLink
Railsrails>= 3.0>= 3.0LinkLink
Rakerake>= 12.0>= 12.0LinkLink
Redisredis>= 3.2>= 3.2LinkLink
Resqueresque>= 1.0, < 2.0>= 1.0, < 2.0LinkLink
Rest Clientrest-client>= 1.8>= 1.8LinkLink
Sequelsequel>= 3.41>= 3.41LinkLink
Shoryukenshoryuken>= 3.2>= 3.2LinkLink
Sidekiqsidekiq>= 3.5.4>= 3.5.4LinkLink
Sinatrasinatra>= 1.4>= 1.4LinkLink
Sneakerssneakers>= 2.12.0>= 2.12.0LinkLink
Sucker Punchsucker_punch>= 2.0>= 2.0LinkLink

Further Reading

Additional helpful documentation, links, and articles: