Upgrading#

Deprecation warnings#

As of v0.60.0, the ddtrace library provides Python warnings for deprecations with an additional warning category ddtrace.DDTraceDeprecationWarning.

This warning category can be used in configuring pytest warnings capture to turn warnings into errors:

pytest -W "error::ddtrace.DDTraceDeprecationWarning" tests.py

In addition, the environment variable DD_TRACE_RAISE_DEPRECATIONWARNING is provided to configure the warning filter to raise an exception in an application instrumented with ddtrace:

DD_TRACE_RAISE_DEPRECATIONWARNING=1 ddtrace-run python app.py

Before v0.60.0, you must enable all deprecation warnings and filter the application or tests logs for deprecations specific to the ddtrace library:

$ python -Wall app.py

# or

$ PYTHONWARNINGS=all python app.py

Upgrade to 1.x#

Environment variables#

Use the following patterns to identify the deprecated environment variables in a code base:

git grep -e "DATADOG_[A-Z_]*" \
  -e "DATADOG_SERVICE_NAME" \
  -e "DD_CALL_BASIC_CONFIG" \
  -e "DD_LOGGING_RATE_LIMIT" \
  -e "DD_SERVICE_NAME" \
  -e "DD_TRACER_PARTIAL_FLUSH_ENABLED" \
  -e "DD_TRACER_PARTIAL_FLUSH_MIN_SPANS"

Upgrade to 2.x#

Environment variables#

Use the following patterns to identify the deprecated environment variables in a code base:

git grep -e "DD_GEVENT_PATCH_ALL" \
  -e "DD_AWS_TAG_ALL_PARAMS" \
  -e "DD_REMOTECONFIG_POLL_SECONDS" \
  -e "DD_CALL_BASIC_CONFIG" \

Legacy tracing interfaces#

Reference the 2.0 release note (../releasenotes/notes/release-2.0-3af0045e2261bd02.yaml) to identify and remove the deprecated legacy tracing interfaces in a code base.