4.0.0

Estimated end-of-life date, accurate to within three months: 05-2027
See the support level definitions for more information.

This is a major-version release that contains many backwards-incompatible changes to public APIs. To find which of these your code relies on, follow the "deprecation warnings" instructions here.

dd-trace-py now includes an OpenFeature provider implementation, enabling feature flag evaluation through the OpenFeature API.

This integration is under active design and development. Functionality and APIs are experimental and may change without notice. For more information, see the Datadog documentation at https://docs.datadoghq.com/feature_flags/#overview

Breaking Changes

• Support for ddtrace with Python 3.8 is removed after being deprecated in the 3.0 release line. Use ddtrace 4.x with Python 3.9 or newer.
• 32-bit linux is no longer supported. Please contact us if this blocks upgrading dd-trace-py.
• mongoengine
  • Drops support for the ddtrace.Pin object with mongoengine. With this change, the ddtrace library no longer directly supports mongoengine. Mongoengine will be supported through the pymongo integration.
• CI Visibility
  • Removed deprecated entry points for the pytest_benchmark and pytest_bdd integrations. These plugins are now supported by the regular pytest integration.
• dynamic instrumentation
  • removed the deprecated DD_DYNAMIC_INSTRUMENTATION_UPLOAD_FLUSH_INTERVAL variable.
• exception replay
  • removed the deprecated DD_EXCEPTION_DEBUGGING_ENABLED variable.
• tracing
  • Deprecated methods have been removed
    • Span.set_tag_str has been removed, use Span.set_tag instead.
    • Span.set_struct_tag has been removed.
    • Span.get_struct_tag has been removed.
    • Span._pprint has been removed
    • Span.finished setter was removed, please use Span.finish() method instead.
    • Tracer.on_start_span method has been removed.
    • Tracer.deregister_on_start_span method has been removed.
    • ddtrace.trace.Pin has been removed.
    • Span.finish_with_ancestors was removed with no replacement.
  • Some methods have had their type signatures changed
    • Span.set_tag typing is now set_tag(key: str, value: Optional[str] = None) -> None
    • Span.get_tag typing is now get_tag(key: str) -> Optional[str]
    • Span.set_tags typing is now set_tags(tags: dict[str, str]) -> None
    • Span.get_tags typing is now get_tags() -> dict[str, str]
    • Span.set_metric typing is now set_metric(key: str, value: int | float) -> None
    • Span.get_metric typing is now get_metric(key: str) -> Optional[int | float]
    • Span.set_metrics typing is now set_metrics(metrics: Dict[str, int | float]) -> None
    • Span.get_metrics typing is now get_metrics() -> dict[str, int | float]
  • Span.record_exception's timestamp and escaped parameters are removed
• LLM Observability
  • manual instrumentation methods, including LLMObs.annotate(), LLMObs.export_span(), LLMObs.submit_evaluation(), LLMObs.inject_distributed_headers(), and LLMObs.activate_distributed_headers() now raise exceptions instead of logging. LLM Observability auto-instrumentation is not affected.
  • LLMObs.submit_evaluation_for() has been removed. Please use LLMObs.submit_evaluation() instead for submitting evaluations. To migrate:
    • LLMObs.submit_evaluation_for(...) users: rename to LLMObs.submit_evaluation(...)
    • LLMObs.submit_evaluation_for(...) users: rename the span_context argument to span, i.e. LLMObs.submit_evaluation(span_context={"span_id": ..., "trace_id": ...}, ...) to LLMObs.submit_evaluation(span={"span_id": ..., "trace_id": ...}, ...)
• profiling
  • this updates echion (the Python stack sampler) to the latest version, which introduces an experimental faster memory copy function.
  • The V1 stack profiler is removed. V2 has been enabled by default since v2.20.0. DD_PROFILING_STACK_V2_ENABLED is now removed.
• freezegun
  • The deprecated freezegun integration is now removed.
• opentracer
  • This change removes the deprecated opentracer package
• aioredis
  • The aioredis integration has been removed.
• google_generativeai
  • The google_generativeai integration has been removed as the google_generativeai library has reached end-of-life.
    As an alternative, you can use the recommended google_genai library and corresponding integration instead.
• openai
  • Streamed chat/completions will no longer have token counts computed using the tiktoken library, and instead
    will default to having their token counts estimated if not explicitly provided in the OpenAI response object. To guarantee accurate streamed token metrics, set stream_options={"include_usage": True} in the OpenAI request.
• django
  • This upgrades the default tracing behavior to enable minimal tracing mode by default (DD_DJANGO_TRACING_MINIMAL now defaults to true). Django ORM, cache, and template instrumentation are disabled by default to eliminate duplicate span creation since library integrations for database drivers (psycopg, MySQLdb, sqlite3), cache clients (redis, memcached), template renderers (Jinja2), and other supported libraries continue to be traced. This reduces performance overhead by removing redundant Django-layer instrumentation. To restore all Django instrumentation, set DD_DJANGO_TRACING_MINIMAL=false, or enable individual features using DD_DJANGO_INSTRUMENT_DATABASES=true, DD_DJANGO_INSTRUMENT_CACHES=true, and DD_DJANGO_INSTRUMENT_TEMPLATES=true.
  • When DD_DJANGO_INSTRUMENT_DATABASES=true (default false), database instrumentation now merges Django-specific tags into database driver spans created by supported integrations (psycopg, sqlite3, MySQLdb, etc.) instead of creating duplicate Django database spans. If the database cursor is not already wrapped by a supported integration, Django wraps it and creates a span. This change reduces overhead and duplicate spans while preserving visibility into database operations.
• Other
  • This change removes the ddtrace.settings package. Environment variables should be used to adjust settings.
  • This change removes the deprecated non_active_span parameter to HttpPropagator.inject
  • This change removes the deprecated environment variable DEFAULT_RUNTIME_METRICS_INTERVAL.

Deprecation Notes

• Support for ddtrace with Python 3.9 is deprecated after Python 3.9 reached its end-of-life.
• Deprecates support for Tornado versions older than v6.1. Use Tornado v6.1 or later.
• Deprecates programmatic tracing configuration via the ddtrace.contrib.tornado module. Configure tracing using environment variables and import ddtrace.auto instead.

New Features

• AAP
  • This introduces security response id for easy identification of blocking responses.
  • API Security schema collection is now supported in AWS Lambda behind an Application Load Balancer or the Lambda Function URL service where the endpoint cannot be reliably known. API Security reuses the endpoint inferred by the trace resource renaming feature or recomputes it when it is not available to perform sampling instead.
  • AppSec instrumentation for downstream request is now enabled by default for urllib3 and requests. It does not require enabling APM instrumentation for urllib3 anymore.
• profiling
  • Add support for threading.RLock (reentrant lock) profiling. The Lock profiler now tracks both threading.Lock and threading.RLock usage, providing comprehensive lock contention visibility for Python applications.
• LLM Observability
  • Previous dataset versions can be optionally pulled by passing the version argument to LLMObs.pull_dataset
  • Datasets have new properties version and latest_version to provide information on the version of the dataset that is being worked with and the latest global version of the dataset, respectively

Bug Fixes

• CI Visibility
  • This fix resolves an issue where repo tags would be fetched while unshallowing to extract commit metadata, causing performance issues for repos with a large number of tags.
  • This fix resolves performance issue affecting coverage collection for Python 3.12+
• data_streams
  • This fix resolves an issue where payload size statistics were not being sent to the backend for Data Streams Monitoring (DSM).
• core
  • This fix resolves an issue where forksafe locks used patched threading primitives from the profiling module, causing performance issues. The forksafe module now uses unpatched threading primitives (Lock, RLock, Event).
• LLM Observability
  • add support for HTTPS_PROXY.
  • Resolves an issue in the bedrock integration where invoking cohere rerank models would result in missing spans due to output formatting index errors.
  • Corrected the description of the assessment argument in submit_evaluation().
  • Resolves an issue where the langchain integration would incorrectly mark Azure OpenAI calls as duplicate llm operations even if the openai integration was enabled.
• Error Tracking
  • Modifies the way exception events are stored such that the exception id is stored instead of the exception object, to prevent TypeErrors with custom exception objects.
• dynamic instrumentation
  • fix issue with line probes matching the wrong source file when multiple source files from different Python path entries share the same name.
• profiling
  • This fix resolves an issue where importing the profiler module after an asyncio Event Loop had been started would make the Profiler blind to the existing Event Loop and its Tasks.
  • DD_PROFILING_API_TIMEOUT doesn't have any effect, and ...

4.0.0rc3

Estimated end-of-life date, accurate to within three months: 05-2027
See the support level definitions for more information.

This is a major-version release that contains many backwards-incompatible changes to public APIs. To find which of these your code relies on, follow the "deprecation warnings" instructions here.

dd-trace-py now includes an OpenFeature provider implementation, enabling feature flag evaluation through the OpenFeature API.

This integration is under active design and development. Functionality and APIs are experimental and may change without notice. For more information, see the Datadog documentation at https://docs.datadoghq.com/feature_flags/#overview

Breaking Changes

• Support for ddtrace with Python 3.8 is removed after being deprecated in the 3.0 release line. Use ddtrace 4.x with Python 3.9 or newer.
• 32-bit linux is no longer supported. Please contact us if this blocks upgrading dd-trace-py.
• mongoengine
  • Drops support for the ddtrace.Pin object with mongoengine. With this change, the ddtrace library no longer directly supports mongoengine. Mongoengine will be supported through the pymongo integration.
• CI Visibility
  • Removed deprecated entry points for the pytest_benchmark and pytest_bdd integrations. These plugins are now supported by the regular pytest integration.
• dynamic instrumentation
  • removed the deprecated DD_DYNAMIC_INSTRUMENTATION_UPLOAD_FLUSH_INTERVAL variable.
• exception replay
  • removed the deprecated DD_EXCEPTION_DEBUGGING_ENABLED variable.
• tracing
  • Deprecated methods have been removed
    • Span.set_tag_str has been removed, use Span.set_tag instead.
    • Span.set_struct_tag has been removed.
    • Span.get_struct_tag has been removed.
    • Span._pprint has been removed
    • Span.finished setter was removed, please use Span.finish() method instead.
    • Tracer.on_start_span method has been removed.
    • Tracer.deregister_on_start_span method has been removed.
    • ddtrace.trace.Pin has been removed.
    • Span.finish_with_ancestors was removed with no replacement.
  • Some methods have had their type signatures changed
    • Span.set_tag typing is now set_tag(key: str, value: Optional[str] = None) -> None
    • Span.get_tag typing is now get_tag(key: str) -> Optional[str]
    • Span.set_tags typing is now set_tags(tags: dict[str, str]) -> None
    • Span.get_tags typing is now get_tags() -> dict[str, str]
    • Span.set_metric typing is now set_metric(key: str, value: int | float) -> None
    • Span.get_metric typing is now get_metric(key: str) -> Optional[int | float]
    • Span.set_metrics typing is now set_metrics(metrics: Dict[str, int | float]) -> None
    • Span.get_metrics typing is now get_metrics() -> dict[str, int | float]
  • Span.record_exception's timestamp and escaped parameters are removed
• LLM Observability
  • manual instrumentation methods, including LLMObs.annotate(), LLMObs.export_span(), LLMObs.submit_evaluation(), LLMObs.inject_distributed_headers(), and LLMObs.activate_distributed_headers() now raise exceptions instead of logging. LLM Observability auto-instrumentation is not affected.
  • LLMObs.submit_evaluation_for() has been removed. Please use LLMObs.submit_evaluation() instead for submitting evaluations. To migrate:
    • LLMObs.submit_evaluation_for(...) users: rename to LLMObs.submit_evaluation(...)
    • LLMObs.submit_evaluation_for(...) users: rename the span_context argument to span, i.e. LLMObs.submit_evaluation(span_context={"span_id": ..., "trace_id": ...}, ...) to LLMObs.submit_evaluation(span={"span_id": ..., "trace_id": ...}, ...)
• profiling
  • this updates echion (the Python stack sampler) to the latest version, which introduces an experimental faster memory copy function.
  • The V1 stack profiler is removed. V2 has been enabled by default since v2.20.0. DD_PROFILING_STACK_V2_ENABLED is now removed.
• freezegun
  • The deprecated freezegun integration is now removed.
• opentracer
  • This change removes the deprecated opentracer package
• aioredis
  • The aioredis integration has been removed.
• google_generativeai
  • The google_generativeai integration has been removed as the google_generativeai library has reached end-of-life.
    As an alternative, you can use the recommended google_genai library and corresponding integration instead.
• openai
  • Streamed chat/completions will no longer have token counts computed using the tiktoken library, and instead
    will default to having their token counts estimated if not explicitly provided in the OpenAI response object. To guarantee accurate streamed token metrics, set stream_options={"include_usage": True} in the OpenAI request.
• django
  • This upgrades the default tracing behavior to enable minimal tracing mode by default (DD_DJANGO_TRACING_MINIMAL now defaults to true). Django ORM, cache, and template instrumentation are disabled by default to eliminate duplicate span creation since library integrations for database drivers (psycopg, MySQLdb, sqlite3), cache clients (redis, memcached), template renderers (Jinja2), and other supported libraries continue to be traced. This reduces performance overhead by removing redundant Django-layer instrumentation. To restore all Django instrumentation, set DD_DJANGO_TRACING_MINIMAL=false, or enable individual features using DD_DJANGO_INSTRUMENT_DATABASES=true, DD_DJANGO_INSTRUMENT_CACHES=true, and DD_DJANGO_INSTRUMENT_TEMPLATES=true.
  • When DD_DJANGO_INSTRUMENT_DATABASES=true (default false), database instrumentation now merges Django-specific tags into database driver spans created by supported integrations (psycopg, sqlite3, MySQLdb, etc.) instead of creating duplicate Django database spans. If the database cursor is not already wrapped by a supported integration, Django wraps it and creates a span. This change reduces overhead and duplicate spans while preserving visibility into database operations.
• Other
  • This change removes the ddtrace.settings package. Environment variables should be used to adjust settings.
  • This change removes the deprecated non_active_span parameter to HttpPropagator.inject
  • This change removes the deprecated environment variable DEFAULT_RUNTIME_METRICS_INTERVAL.

Deprecation Notes

• Support for ddtrace with Python 3.9 is deprecated after Python 3.9 reached its end-of-life.
• Deprecates support for Tornado versions older than v6.1. Use Tornado v6.1 or later.
• Deprecates programmatic tracing configuration via the ddtrace.contrib.tornado module. Configure tracing using environment variables and import ddtrace.auto instead.

New Features

• AAP
  • This introduces security response id for easy identification of blocking responses.
  • API Security schema collection is now supported in AWS Lambda behind an Application Load Balancer or the Lambda Function URL service where the endpoint cannot be reliably known. API Security reuses the endpoint inferred by the trace resource renaming feature or recomputes it when it is not available to perform sampling instead.
  • AppSec instrumentation for downstream request is now enabled by default for urllib3 and requests. It does not require enabling APM instrumentation for urllib3 anymore.
• profiling
  • Add support for threading.RLock (reentrant lock) profiling. The Lock profiler now tracks both threading.Lock and threading.RLock usage, providing comprehensive lock contention visibility for Python applications.
• LLM Observability
  • Previous dataset versions can be optionally pulled by passing the version argument to LLMObs.pull_dataset
  • Datasets have new properties version and latest_version to provide information on the version of the dataset that is being worked with and the latest global version of the dataset, respectively

Bug Fixes

• CI Visibility
  • This fix resolves an issue where repo tags would be fetched while unshallowing to extract commit metadata, causing performance issues for repos with a large number of tags.
  • This fix resolves performance issue affecting coverage collection for Python 3.12+
• data_streams
  • This fix resolves an issue where payload size statistics were not being sent to the backend for Data Streams Monitoring (DSM).
• core
  • This fix resolves an issue where forksafe locks used patched threading primitives from the profiling module, causing performance issues. The forksafe module now uses unpatched threading primitives (Lock, RLock, Event).
• LLM Observability
  • add support for HTTPS_PROXY.
  • Resolves an issue in the bedrock integration where invoking cohere rerank models would result in missing spans due to output formatting index errors.
  • Corrected the description of the assessment argument in submit_evaluation().
  • Resolves an issue where the langchain integration would incorrectly mark Azure OpenAI calls as duplicate llm operations even if the openai integration was enabled.
• Error Tracking
  • Modifies the way exception events are stored such that the exception id is stored instead of the exception object, to prevent TypeErrors with custom exception objects.
• dynamic instrumentation
  • fix issue with line probes matching the wrong source file when multiple source files from different Python path entries share the same name.
• profiling
  • This fix resolves an issue where importing the profiler module after an asyncio Event Loop had been started would make the Profiler blind to the existing Event Loop and its Tasks.
  • DD_PROFILING_API_TIMEOUT doesn't have any effect, and ...

3.19.0

Estimated end-of-life date, accurate to within three months: 08-2026
See the support level definitions for more information.

Upgrade Notes

• profiling
  • This updates echion (the Python stack sampler) to the latest version, which introduces an experimental faster memory copy function.

Deprecation Notes

• tracing
  • Span.finished setter is deprecated, use Span.finish() method instead.
  • Span.finish_with_ancestors() is deprecated with no alternative.
• LLM Observability
  • The ExperimentResult class' rows and summary_evaluations attributes are deprecated and will be removed in the next major release. ExperimentResult.rows/summary_evaluations attributes will only store the results of the first run iteration for multi-run experiments. Use the ExperimentResult.runs attribute instead to access experiment results and summary evaluations.

New Features

• AAP
  • This introduces security response id for easy identification of blocking responses.
• LLM Observability
  • Experiments can now be run multiple times by using the optional runs argument, to assess the true performance of an experiment in the face of the non determinism of LLMs. Use the new ExperimentResult class' runs attribute to access the results and summary evaluations by run iteration.
  • Non-root experiment spans are now tagged with experiment ID, run ID, and run iteration tags.
  • Adds additional tags to MCP client session and tool call spans to power LLM Observability MCP tool call features.
• mcp
  • Marks client mcp tool call spans as errors when the corresponding server tool call errored

Bug Fixes

• CI Visibility
  • This fix resolves an issue where repo tags would be fetched while unshallowing to extract commit metadata, causing performance issues for repos with a large number of tags.
• data_streams
  • This fix resolves an issue where payload size statistics were not being sent to the backend for Data Streams Monitoring (DSM).
• core
  • This fix resolves an issue where forksafe locks used patched threading primitives from the profiling module, causing performance issues. The forksafe module now uses unpatched threading primitives (Lock, RLock, Event).
• LLM Observability
  • Add support for HTTPS_PROXY.
• Error Tracking
  • Modifies the way exception events are stored such that the exception id is stored instead of the exception object, to prevent TypeErrors with custom exception objects.
• profiling
  • This fix resolves an issue where importing the profiler module after an asyncio Event Loop had been started would make the Profiler blind to the existing Event Loop and its Tasks.
• other
  • Prevent a potential ResourceWarning in multiprocess scenarios.
  • Prevent startup failure when a temporary directory is not available.

Other Changes

• profiling
  • This removes the wrapt library dependency from the Lock Profiler implementation, improving performance and reducing overhead during lock instrumentation.

3.19.0rc1

Estimated end-of-life date, accurate to within three months: 08-2026
See the support level definitions for more information.

Upgrade Notes

• profiling
  • This updates echion (the Python stack sampler) to the latest version, which introduces an experimental faster memory copy function.

Deprecation Notes

• tracing
  • Span.finished setter is deprecated, use Span.finish() method instead.
  • Span.finish_with_ancestors() is deprecated with no alternative.
• LLM Observability
  • The ExperimentResult class' rows and summary_evaluations attributes are deprecated and will be removed in the next major release. ExperimentResult.rows/summary_evaluations attributes will only store the results of the first run iteration for multi-run experiments. Use the ExperimentResult.runs attribute instead to access experiment results and summary evaluations.

New Features

• AAP
  • This introduces security response id for easy identification of blocking responses.
• LLM Observability
  • Experiments can now be run multiple times by using the optional runs argument, to assess the true performance of an experiment in the face of the non determinism of LLMs. Use the new ExperimentResult class' runs attribute to access the results and summary evaluations by run iteration.
  • Non-root experiment spans are now tagged with experiment ID, run ID, and run iteration tags.
  • Adds additional tags to MCP client session and tool call spans to power LLM Observability MCP tool call features.
• mcp
  • Marks client mcp tool call spans as errors when the corresponding server tool call errored

Bug Fixes

• CI Visibility
  • This fix resolves an issue where repo tags would be fetched while unshallowing to extract commit metadata, causing performance issues for repos with a large number of tags.
• data_streams
  • This fix resolves an issue where payload size statistics were not being sent to the backend for Data Streams Monitoring (DSM).
• core
  • This fix resolves an issue where forksafe locks used patched threading primitives from the profiling module, causing performance issues. The forksafe module now uses unpatched threading primitives (Lock, RLock, Event).
• LLM Observability
  • Add support for HTTPS_PROXY.
• Error Tracking
  • Modifies the way exception events are stored such that the exception id is stored instead of the exception object, to prevent TypeErrors with custom exception objects.
• profiling
  • This fix resolves an issue where importing the profiler module after an asyncio Event Loop had been started would make the Profiler blind to the existing Event Loop and its Tasks.
• other
  • Prevent a potential ResourceWarning in multiprocess scenarios.
  • Prevent startup failure when a temporary directory is not available.

Other Changes

• profiling
  • This removes the wrapt library dependency from the Lock Profiler implementation, improving performance and reducing overhead during lock instrumentation.

4.0.0rc2

Estimated end-of-life date, accurate to within three months: 05-2027
See the support level definitions for more information.

This is a major-version release that contains many backwards-incompatible changes to public APIs. To find which of these your code relies on, follow the "deprecation warnings" instructions here.

dd-trace-py now includes an OpenFeature provider implementation, enabling feature flag evaluation through the OpenFeature API.

This integration is under active design and development. Functionality and APIs are experimental and may change without notice. For more information, see the Datadog documentation at https://docs.datadoghq.com/feature_flags/#overview

Breaking Changes

• Support for ddtrace with Python 3.8 is removed after being deprecated in the 3.0 release line. Use ddtrace 4.x with Python 3.9 or newer.
• 32-bit linux is no longer supported. Please contact us if this blocks upgrading dd-trace-py.
• mongoengine
  • Drops support for the ddtrace.Pin object with mongoengine. With this change, the ddtrace library no longer directly supports mongoengine. Mongoengine will be supported through the pymongo integration.
• CI Visibility
  • Removed deprecated entry points for the pytest_benchmark and pytest_bdd integrations. These plugins are now supported by the regular pytest integration.
• dynamic instrumentation
  • removed the deprecated DD_DYNAMIC_INSTRUMENTATION_UPLOAD_FLUSH_INTERVAL variable.
• exception replay
  • removed the deprecated DD_EXCEPTION_DEBUGGING_ENABLED variable.
• tracing
  • Deprecated methods have been removed
    • Span.set_tag_str has been removed, use Span.set_tag instead.
    • Span.set_struct_tag has been removed.
    • Span.get_struct_tag has been removed.
    • Span._pprint has been removed
    • Span.finished setter was removed, please use Span.finish() method instead.
    • Tracer.on_start_span method has been removed.
    • Tracer.deregister_on_start_span method has been removed.
    • ddtrace.trace.Pin has been removed.
    • Span.finish_with_ancestors was removed with no replacement.
  • Some methods have had their type signatures changed
    • Span.set_tag typing is now set_tag(key: str, value: Optional[str] = None) -> None
    • Span.get_tag typing is now get_tag(key: str) -> Optional[str]
    • Span.set_tags typing is now set_tags(tags: dict[str, str]) -> None
    • Span.get_tags typing is now get_tags() -> dict[str, str]
    • Span.set_metric typing is now set_metric(key: str, value: int | float) -> None
    • Span.get_metric typing is now get_metric(key: str) -> Optional[int | float]
    • Span.set_metrics typing is now set_metrics(metrics: Dict[str, int | float]) -> None
    • Span.get_metrics typing is now get_metrics() -> dict[str, int | float]
  • Span.record_exception's timestamp and escaped parameters are removed
• LLM Observability
  • manual instrumentation methods, including LLMObs.annotate(), LLMObs.export_span(), LLMObs.submit_evaluation(), LLMObs.inject_distributed_headers(), and LLMObs.activate_distributed_headers() now raise exceptions instead of logging. LLM Observability auto-instrumentation is not affected.
  • LLMObs.submit_evaluation_for() has been removed. Please use LLMObs.submit_evaluation() instead for submitting evaluations. To migrate:
    • LLMObs.submit_evaluation_for(...) users: rename to LLMObs.submit_evaluation(...)
    • LLMObs.submit_evaluation_for(...) users: rename the span_context argument to span, i.e. LLMObs.submit_evaluation(span_context={"span_id": ..., "trace_id": ...}, ...) to LLMObs.submit_evaluation(span={"span_id": ..., "trace_id": ...}, ...)
• profiling
  • this updates echion (the Python stack sampler) to the latest version, which introduces an experimental faster memory copy function.
  • The V1 stack profiler is removed. V2 has been enabled by default since v2.20.0. DD_PROFILING_STACK_V2_ENABLED is now removed.
• freezegun
  • The deprecated freezegun integration is now removed.
• opentracer
  • This change removes the deprecated opentracer package
• aioredis
  • The aioredis integration has been removed.
• google_generativeai
  • The google_generativeai integration has been removed as the google_generativeai library has reached end-of-life.
    As an alternative, you can use the recommended google_genai library and corresponding integration instead.
• openai
  • Streamed chat/completions will no longer have token counts computed using the tiktoken library, and instead
    will default to having their token counts estimated if not explicitly provided in the OpenAI response object. To guarantee accurate streamed token metrics, set stream_options={"include_usage": True} in the OpenAI request.
• django
  • This upgrades the default tracing behavior to enable minimal tracing mode by default (DD_DJANGO_TRACING_MINIMAL now defaults to true). Django ORM, cache, and template instrumentation are disabled by default to eliminate duplicate span creation since library integrations for database drivers (psycopg, MySQLdb, sqlite3), cache clients (redis, memcached), template renderers (Jinja2), and other supported libraries continue to be traced. This reduces performance overhead by removing redundant Django-layer instrumentation. To restore all Django instrumentation, set DD_DJANGO_TRACING_MINIMAL=false, or enable individual features using DD_DJANGO_INSTRUMENT_DATABASES=true, DD_DJANGO_INSTRUMENT_CACHES=true, and DD_DJANGO_INSTRUMENT_TEMPLATES=true.
  • When DD_DJANGO_INSTRUMENT_DATABASES=true (default false), database instrumentation now merges Django-specific tags into database driver spans created by supported integrations (psycopg, sqlite3, MySQLdb, etc.) instead of creating duplicate Django database spans. If the database cursor is not already wrapped by a supported integration, Django wraps it and creates a span. This change reduces overhead and duplicate spans while preserving visibility into database operations.
• Other
  • This change removes the ddtrace.settings package. Environment variables should be used to adjust settings.
  • This change removes the deprecated non_active_span parameter to HttpPropagator.inject
  • This change removes the deprecated environment variable DEFAULT_RUNTIME_METRICS_INTERVAL.

Deprecation Notes

• Support for ddtrace with Python 3.9 is deprecated after Python 3.9 reached its end-of-life.

New Features

• AAP
  • This introduces security response id for easy identification of blocking responses.
  • API Security schema collection is now supported in AWS Lambda behind an Application Load Balancer or the Lambda Function URL service where the endpoint cannot be reliably known. API Security reuses the endpoint inferred by the trace resource renaming feature or recomputes it when it is not available to perform sampling instead.
  • AppSec instrumentation for downstream request is now enabled by default for urllib3 and requests. It does not require enabling APM instrumentation for urllib3 anymore.
• profiling
  • Add support for threading.RLock (reentrant lock) profiling. The Lock profiler now tracks both threading.Lock and threading.RLock usage, providing comprehensive lock contention visibility for Python applications.
• LLM Observability
  • Previous dataset versions can be optionally pulled by passing the version argument to LLMObs.pull_dataset
  • Datasets have new properties version and latest_version to provide information on the version of the dataset that is being worked with and the latest global version of the dataset, respectively

Bug Fixes

• CI Visibility
  • This fix resolves an issue where repo tags would be fetched while unshallowing to extract commit metadata, causing performance issues for repos with a large number of tags.
  • This fix resolves performance issue affecting coverage collection for Python 3.12+
• data_streams
  • This fix resolves an issue where payload size statistics were not being sent to the backend for Data Streams Monitoring (DSM).
• core
  • This fix resolves an issue where forksafe locks used patched threading primitives from the profiling module, causing performance issues. The forksafe module now uses unpatched threading primitives (Lock, RLock, Event).
• LLM Observability
  • add support for HTTPS_PROXY.
  • Resolves an issue in the bedrock integration where invoking cohere rerank models would result in missing spans due to output formatting index errors.
  • Corrected the description of the assessment argument in submit_evaluation().
  • Resolves an issue where the langchain integration would incorrectly mark Azure OpenAI calls as duplicate llm operations even if the openai integration was enabled.
• Error Tracking
  • Modifies the way exception events are stored such that the exception id is stored instead of the exception object, to prevent TypeErrors with custom exception objects.
• dynamic instrumentation
  • fix issue with line probes matching the wrong source file when multiple source files from different Python path entries share the same name.
• profiling
  • This fix resolves an issue where importing the profiler module after an asyncio Event Loop had been started would make the Profiler blind to the existing Event Loop and its Tasks.
  • DD_PROFILING_API_TIMEOUT doesn't have any effect, and is marked to be removed in upcoming 4.0 release. New environment variable DD_PROFILING_API_TIMEOUT_MS is introduced to configure timeout for uploading profiles to the backend. The default value is 10000 ms (10 seconds)
  • Upgrades echion to resolve an issue w...

4.0.0rc1

Estimated end-of-life date, accurate to within three months: 05-2027
See the support level definitions for more information.

This is a major-version release that contains many backwards-incompatible changes to public APIs. To find which of these your code relies on, follow the "deprecation warnings" instructions here.

Breaking Changes

• Support for ddtrace with Python 3.8 is removed after being deprecated in the 3.0 release line. Use ddtrace 4.x with Python 3.9 or newer.
• mongoengine
  • Drops support for the ddtrace.Pin object with mongoengine. With this change, the ddtrace library no longer directly supports mongoengine. Mongoengine will be supported through the pymongo integration.
• CI Visibility
  • Removed deprecated entry points for the pytest_benchmark and pytest_bdd integrations. These plugins are now supported by the regular pytest integration.
• dynamic instrumentation
  • removed the deprecated DD_DYNAMIC_INSTRUMENTATION_UPLOAD_FLUSH_INTERVAL variable.
• exception replay
  • removed the deprecated DD_EXCEPTION_DEBUGGING_ENABLED variable.
• tracing
  • Deprecated methods have been removed
    • Span.set_tag_str has been removed, use Span.set_tag instead.
    • Span.set_struct_tag has been removed.
    • Span.get_struct_tag has been removed.
    • Span._pprint has been removed
    • Span.finished setter was removed, please use Span.finish() method instead.
    • Tracer.on_start_span method has been removed.
    • Tracer.deregister_on_start_span method has been removed.
    • ddtrace.trace.Pin has been removed.
    • Span.finish_with_ancestors was removed with no replacement.
  • Some methods have had their type signatures changed
    • Span.set_tag typing is now set_tag(key: str, value: Optional[str] = None) -> None
    • Span.get_tag typing is now get_tag(key: str) -> Optional[str]
    • Span.set_tags typing is now set_tags(tags: dict[str, str]) -> None
    • Span.get_tags typing is now get_tags() -> dict[str, str]
    • Span.set_metric typing is now set_metric(key: str, value: int | float) -> None
    • Span.get_metric typing is now get_metric(key: str) -> Optional[int | float]
    • Span.set_metrics typing is now set_metrics(metrics: Dict[str, int | float]) -> None
    • Span.get_metrics typing is now get_metrics() -> dict[str, int | float]
  • Span.record_exception's timestamp and escaped parameters are removed
• LLM Observability
  • manual instrumentation methods, including LLMObs.annotate(), LLMObs.export_span(), LLMObs.submit_evaluation(), LLMObs.inject_distributed_headers(), and LLMObs.activate_distributed_headers() now raise exceptions instead of logging. LLM Observability auto-instrumentation is not affected.
  • LLMObs.submit_evaluation_for() has been removed. Please use LLMObs.submit_evaluation() instead for submitting evaluations. To migrate:
    • LLMObs.submit_evaluation_for(...) users: rename to LLMObs.submit_evaluation(...)
    • LLMObs.submit_evaluation_for(...) users: rename the span_context argument to span, i.e. LLMObs.submit_evaluation(span_context={"span_id": ..., "trace_id": ...}, ...) to LLMObs.submit_evaluation(span={"span_id": ..., "trace_id": ...}, ...)
• profiling
  • this updates echion (the Python stack sampler) to the latest version, which introduces an experimental faster memory copy function.
  • The V1 stack profiler is removed. V2 has been enabled by default since v2.20.0. DD_PROFILING_STACK_V2_ENABLED is now removed.
• freezegun
  • The deprecated freezegun integration is now removed.
• opentracer
  • This change removes the deprecated opentracer package
• google_generativeai
  • The google_generativeai integration has been removed as the google_generativeai library has reached end-of-life.
    As an alternative, you can use the recommended google_genai library and corresponding integration instead.
• openai
  • Streamed chat/completions will no longer have token counts computed using the tiktoken library, and instead
    will default to having their token counts estimated if not explicitly provided in the OpenAI response object. To guarantee accurate streamed token metrics, set stream_options={"include_usage": True} in the OpenAI request.
• django
  • This upgrades the default tracing behavior to enable minimal tracing mode by default (DD_DJANGO_TRACING_MINIMAL now defaults to true). Django ORM, cache, and template instrumentation are disabled by default to eliminate duplicate span creation since library integrations for database drivers (psycopg, MySQLdb, sqlite3), cache clients (redis, memcached), template renderers (Jinja2), and other supported libraries continue to be traced. This reduces performance overhead by removing redundant Django-layer instrumentation. To restore all Django instrumentation, set DD_DJANGO_TRACING_MINIMAL=false, or enable individual features using DD_DJANGO_INSTRUMENT_DATABASES=true, DD_DJANGO_INSTRUMENT_CACHES=true, and DD_DJANGO_INSTRUMENT_TEMPLATES=true.
  • When DD_DJANGO_INSTRUMENT_DATABASES=true (default false), database instrumentation now merges Django-specific tags into database driver spans created by supported integrations (psycopg, sqlite3, MySQLdb, etc.) instead of creating duplicate Django database spans. If the database cursor is not already wrapped by a supported integration, Django wraps it and creates a span. This change reduces overhead and duplicate spans while preserving visibility into database operations.
• Other
  • This change removes the ddtrace.settings package. Environment variables should be used to adjust settings.
  • This change removes the deprecated non_active_span parameter to HttpPropagator.inject
  • This change removes the deprecated environment variable DEFAULT_RUNTIME_METRICS_INTERVAL.

Deprecation Notes

• Support for ddtrace with Python 3.9 is deprecated after Python 3.9 reached its end-of-life.

New Features

• AAP
  • This introduces security response id for easy identification of blocking responses.
  • API Security schema collection is now supported in AWS Lambda behind an Application Load Balancer or the Lambda Function URL service where the endpoint cannot be reliably known. API Security reuses the endpoint inferred by the trace resource renaming feature or recomputes it when it is not available to perform sampling instead.
  • AppSec instrumentation for downstream request is now enabled by default for urllib3 and requests. It does not require enabling APM instrumentation for urllib3 anymore.
• profiling
  • Add support for threading.RLock (reentrant lock) profiling. The Lock profiler now tracks both threading.Lock and threading.RLock usage, providing comprehensive lock contention visibility for Python applications.
• LLM Observability
  • Previous dataset versions can be optionally pulled by passing the version argument to LLMObs.pull_dataset
  • Datasets have new properties version and latest_version to provide information on the version of the dataset that is being worked with and the latest global version of the dataset, respectively

Bug Fixes

• CI Visibility
  • This fix resolves an issue where repo tags would be fetched while unshallowing to extract commit metadata, causing performance issues for repos with a large number of tags.
  • This fix resolves performance issue affecting coverage collection for Python 3.12+
• data_streams
  • This fix resolves an issue where payload size statistics were not being sent to the backend for Data Streams Monitoring (DSM).
• core
  • This fix resolves an issue where forksafe locks used patched threading primitives from the profiling module, causing performance issues. The forksafe module now uses unpatched threading primitives (Lock, RLock, Event).
• LLM Observability
  • add support for HTTPS_PROXY.
  • Resolves an issue in the bedrock integration where invoking cohere rerank models would result in missing spans due to output formatting index errors.
  • Corrected the description of the assessment argument in submit_evaluation().
  • Resolves an issue where the langchain integration would incorrectly mark Azure OpenAI calls as duplicate llm operations even if the openai integration was enabled.
• Error Tracking
  • Modifies the way exception events are stored such that the exception id is stored instead of the exception object, to prevent TypeErrors with custom exception objects.
• profiling
  • This fix resolves an issue where importing the profiler module after an asyncio Event Loop had been started would make the Profiler blind to the existing Event Loop and its Tasks.
  • DD_PROFILING_API_TIMEOUT doesn't have any effect, and is marked to be removed in upcoming 4.0 release. New environment variable DD_PROFILING_API_TIMEOUT_MS is introduced to configure timeout for uploading profiles to the backend. The default value is 10000 ms (10 seconds)
  • Upgrades echion to resolve an issue where stack profiler can allocate a large amount of memory unnecessarily. Resolves another issue where the profiler can loop infinitely on Python 3.13.
  • This fix resolves an issue where AssertionError exceptions were silently suppressed in the _acquire method of the Lock profiler (note: this only occurs when assertions are enabled.)
• kafka
  • This fix resolves an issue where only the first message in a batch was dispatched to Data Streams Monitoring (DSM) when consuming multiple Kafka messages
• langchain
  • This fix resolves an issue where auto instrumented prompt templates incorrectly included a version field. The version field is now omitted unless explicitly set by the user.
    ...