This documentation is for datadog gem v2.x. If you are looking for ddtrace gem v1.x documentation, see the legacy Ruby Compatibility Requirements documentation.


The Ruby Datadog Trace library is open source. See the dd-trace-rb GitHub repository for more information.

Supported Ruby interpreters

TypeDocumentationVersionSupport typeGem version support
2.4EOL< 2.0.0
2.3EOL< 2.0.0
2.2EOL< 2.0.0
2.1EOL< 2.0.0
2.0EOL< 0.50.0
1.9EOL< 0.27.0

Supported web servers

TypeDocumentationVersionSupport type
Puma / 3.6+latest
Unicorn / 5.1+latest

Supported tracing frameworks

TypeDocumentationVersionSupport typeGem version support
OpenTracing< 2.0.0

Supported operating systems

OSSupport typePackage version
Linux x86_64latestLatest
Linux aarch64latestLatest
macOSDev environments onlyLatest
MS WindowsUnimplementedLatest

Need linux support for a CPU architecture not listed? Contact our customer support team for special requests.

Supported Datadog agent versions

Datadog Agent versionSupport typePackage version


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

NameKeyVersions Supported: MRIVersions Supported: JRubyHow to configureGem source
Action Cableaction_cable>= 5.0>= 5.0LinkLink
Action Maileraction_mailer>= 5.0>= 5.0LinkLink
Action Packaction_pack>= 4.0>= 4.0LinkLink
Action Viewaction_view>= 4.0>= 4.0LinkLink
Active Jobactive_job>= 4.2>= 4.2LinkLink
Active Model Serializersactive_model_serializers>= 0.9>= 0.9LinkLink
Active Recordactive_record>= 4.0>= 4.0LinkLink
Active Supportactive_support>= 4.0>= 4.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>= 2.2.6, 2.1.11+,2.0.28+, 1.13.21+>= 2.2.6, 2.1.11+,2.0.28+, 1.13.21+LinkLink
gRPCgrpc>= 1.7gem not availableLinkLink
hanamihanami>= 1, < 2>= 1, < 2LinkLink
http.rbhttprb>= 2.0>= 2.0LinkLink
httpclienthttpclient>= 2.2>= 2.2LinkLink
httpxhttpx>= 0.11>= 0.11LinkLink
Kafkaruby-kafka>= 0.7.10>= 0.7.10LinkLink
Makara (via Active Record)makara>= 0.3.5>= 0.3.5LinkLink
MongoDBmongo>= 2.1>= 2.1LinkLink
MySQL2mysql2>= 0.3.21gem not availableLinkLink
Net/HTTPhttp(Any supported Ruby)(Any supported Ruby)LinkLink
OpenSearchopensearch-ruby>= 1.0.0>= 1.0.0LinkLink
Postgrespg>= 0.18.4gem not availableLinkLink
Prestopresto>= 0.5.14>= 0.5.14LinkLink
Queque>= 1.0.0.beta2>= 1.0.0.beta2LinkLink
Racecarracecar>= 0.3.5>= 1.3.5LinkLink
Rackrack>= 1.1>= 1.1LinkLink
Railsrails>= 4.0>= 4.0LinkLink
Rakerake>= 12.0>= 12.0LinkLink
Redisredis>= 3.2>= 3.2LinkLink
Resqueresque>= 1.0>= 1.0LinkLink
Rest Clientrest-client>= 1.8>= 1.8LinkLink
Rodaroda>= 2.1, <4>= 2.1, <4LinkLink
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
Stripestripe>= 5.15.0>= 5.15.0LinkLink
Sucker Punchsucker_punch>= 2.0>= 2.0LinkLink

Support Policy

Datadog for Ruby is built upon dependencies defined in specific versions of the host operating system, Ruby runtime, certain Ruby libraries, and the Datadog Agent/API. When these versions are no longer supported by their maintainers, Datadog for Ruby limits its support for these as well.

Levels of Support

LevelSupport provided
UnsupportedPossibly functional, but not tested or supported. Contact our customer support team for special requests.
UnimplementedNo implementation. Contact our customer support team for special requests.
Pre-releaseInitial implementation. May not yet contain all features. Support for new features, bug & security fixes provided on a best-effort basis.
LatestFull implementation of all features. Full support for new features, bug & security fixes.
MaintenanceFull implementation of existing features. Does not receive new features. Support for critical bug & security fixes only.
End-of-life (EOL)No support. The version can still be used but no bugfixes will be provided.

Package Versioning

Datadog for Ruby practices semantic versioning.

As this relates to downgrading runtime support, it implies:

  • Major version updates (e.g. 1.0.0 to 2.0.0) may change support for any runtime from Beta/Latest to Maintenance/EOL.
  • Minor version updates (e.g. 1.0.0 to 1.1.0) may change support for any runtime from Beta/Latest to Maintenance.
  • Patch version updates (e.g. 1.0.0 to 1.0.1) will not change support for any runtime.

Library version support

Datadog for Ruby will provide GA support for the latest major version and maintenance support for the previous major version of the library. This support will be provided through the latest minor or patch version of the major version. For example, if 1.21.0 is the latest version of the library with maintenance support, bug fixes will be provided via a new release of 1.21.0 (or 1.20.1). Those bugfixes will not be backported as patches to previous minor versions of 1.x.

Gem Major VersionSupport type

Additional support resources