Release Notes

New Features

• Add official support for Python 3.10
• Add aredis support >= 1.1.0
• Add automatic unix domain socket detection for Dogstatsd. The expected path for the socket is /var/run/datadog/dsd.socket which if exists, will be used instead of the previous UDP default, udp://localhost:8125/. To be used in conjunction with dogstatsd_socket in your datadog.yaml file, or the DD_DOGSTATSD_SOCKET environment variable set on the Datadog agent.
• Add new DD_TRACE_SAMPLING_RULES environment variable to override default sampling rules. For example: DD_TRACE_SAMPLING_RULES='[{"sample_rate":0.5,"service":"my-service"}]'
• Add support for snowflake-connector-python >= 2.0.0. Note that this integration is in beta and is not enabled by default. See the snowflake integration documentation for how to enable.
• Only for CI Visibility (pytest integration): include pytest version as a tag in the test span.
• Only for CI Visibility (pytest integration): Extract stage and job name from environment data in Azure Pipelines.

Upgrade Notes

• Instead of using error constants from ddtrace.ext.errors. Use constants from ddtrace.constants module. For example: ddtrace.ext.errors.ERROR_MSG -> ddtrace.constants.ERROR_MSG
• Instead of using priority constants from ddtrace.ext.priority. Use constants from ddtrace.constants module. For example: ddtrace.ext.priority.AUTO_KEEP -> ddtrace.constants.AUTO_KEEP
• Instead of using system constants from ddtrace.ext.system. Use constants from ddtrace.constants module. For example: ddtrace.ext.system.PID -> ddtrace.constants.PID

Deprecation Notes

• Deprecate DATADOG_TRACE_AGENT_HOSTNAME, DATADOG_TRACE_AGENT_PORT, DATADOG_PRIORITY_SAMPLING, DATADOG_PATCH_MODULES in favor of their DD equivalents.

  [Deprecated environment variable] | [Recommended environment variable]

  • For DATADOG_TRACE_AGENT_HOSTNAME, use DD_AGENT_HOST
  • For DATADOG_TRACE_AGENT_PORT use DD_AGENT_PORT
  • For DATADOG_PRIORITY_SAMPLING, follow ingestion controls
  • For DATADOG_PATCH_MODULES, use DD_PATCH_MODULES

• Moved ddtrace.ext.errors constants into the ddtrace.constants module. ddtrace.ext.errors will be removed in v1.0. Shorthand error constant (MSG,TYPE,STACK) in ddtrace.ext.errors will be removed in v1.0. Function get_traceback() in ddtrace.ext.errors is now deprecated and will be removed v1.0.

• Moved ddtrace.ext.priority constants into ddtrace.constants module.

• Moved ddtrace.ext.system constants into ddtrace.constants module.

Bug Fixes

• Fixes an issue where all Django function middleware will share the same resource name.
• Fixed an issue with gevent worker processes that caused them to crash and stop.
• Fixes exceptions raised when logging during tracer initialization when DD_LOGS_INJECTION is enabled.
• The ddtrace.utils.wrappers.unwrap function now raises an error if trying to unwrap a non-wrapped object.
• Only for CI Visibility (pytest integration): Fix extraction of branch in GitLab CI.