UpgradeGuide.md

Upgrading from ddtrace 1.x to datadog-ci

Test visibility for Ruby is no longer part of datadog gem and fully migrated to datadog-ci gem. To continue using it after gem datadog v2.0 is released, do these changes.

Add datadog-ci to your gemfile

Before:

gem "ddtrace", "~> 1.0"

After:

group :test do
  gem "datadog-ci", "~> 1.0"
end

Or if you use other Datadog products:

gem "datadog", "~> 2.0"

group :test do
  gem "datadog-ci", "~> 1.0"
end

Change WebMock or VCR configuration

New test visibility features (such as intelligent test runner, git metadata upload, code coverage support) require some DataDog endpoints to be allowlisted by WebMock/VCR tools when using agentless mode.

For WebMock allow all requests that match datadoghq:

WebMock.disable_net_connect!(:allow => /datadoghq/)

For VCR provide ignore_request configuration:

VCR.configure do |config|
  config.ignore_request do |request|
    # ignore all requests to datadoghq hosts
    request.uri =~ /datadoghq/
  end
end

Upgrade tracing auto instrumentation

If you use auto instrumenation feature from tracing you need to change the require:

# === Before ===
require 'ddtrace/auto_instrument'

# === After ===
require 'datadog/auto_instrument'