Upgrading

Upgrade 0.x

Deprecation warnings

As of v0.60.0, the 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

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"