Datadog SDK
Backend & InfraDatadog Python APM Client
Release History
v4.2.0v4.2.0rc321 fixes17 featuresThis release introduces significant new features for LLM Observability, enhanced profiling capabilities for asyncio locks and tasks, and business logic detection for Stripe via AAP. It also deprecates the `Hooks` class in favor of direct span utility functions.
v4.2.0rc221 fixes17 featuresThis release introduces significant new features for LLM Observability, enhanced profiling capabilities for asyncio locks and tasks, and business logic detection for Stripe via AAP. It also deprecates the `Hooks` class in favor of direct span utility functions.
v4.1.36 fixesThis release focuses primarily on bug fixes across SSI, LLM Observability, and profiling, improving stability, context management, and stack accuracy.
v4.0.34 fixesThis release focuses on bug fixes across CI Visibility and profiling modules, addressing issues related to code coverage instrumentation, uvloop/forking crashes, memory profiler loading, and asyncio dependency tracking.
v3.19.44 fixesThis release focuses on bug fixes across CI Visibility and Profiling modules, and deprecates warning logs for incorrect LLM Observability SDK usage, signaling future error raising.
v4.2.0rc117 fixes14 featuresThis release introduces significant new features for LLM Observability, enhanced profiling capabilities for asyncio locks, and business logic detection for Stripe. It also deprecates the `Hooks` class in favor of direct span utility functions.
v4.1.22 fixesThis release primarily focuses on bug fixes, addressing a crash related to Ray job metadata and correcting the native extension module location for profiling builds.
v4.1.11 fixThis release primarily addresses a bug in the Debugger component by reverting a recent change that caused "context already registered" errors when a specific environment variable was set.
v4.0.23 fixesThis release focuses on several bug fixes across different components, including improved event deduplication in OpenFeature, resolution of API key parsing issues in OpenAI, and stability fixes in the profiler.
v4.1.018 fixes25 featuresThis release introduces significant new features in Continuous Profiling (support for Python 3.14, new lock profiling types) and LLM Observability (multi-run experiments, enhanced tagging). It also deprecates older Tornado versions and resolves several critical bugs related to exception replay, IAST memory safety in forked processes, and tracing initialization in Ray jobs.
v4.1.0rc3Breaking18 fixes28 featuresThis release removes the aioredis integration and drops support for 32-bit Linux, while introducing extensive new features for Python profiling (including Python 3.14 support) and significant enhancements to LLM Observability, including multi-run experiment tracking and richer span tagging.
v4.1.0rc2Breaking18 fixes27 featuresThis release introduces significant new features in Profiling and LLM Observability, including support for new Python primitives and multi-run experiments. It also removes the aioredis integration and drops support for 32-bit Linux environments.
v3.19.31 fixThis release primarily focuses on stability improvements by resolving a potential deadlock issue within the tracing mechanism.
v4.0.19 fixesThis release focuses heavily on stability and security, addressing critical memory safety issues in IAST, resolving deadlocks upon forking, and fixing numerous bugs across profiling, AppSec, and LLM observability integrations.
v3.19.21 fixThis release primarily focuses on improving the reliability of span parsing within the Profiling feature.
v4.1.0rc1Breaking13 fixes28 featuresThis release introduces experimental OpenFeature provider support and significant enhancements to LLM Observability, including richer span tagging and multi-run experiment tracking. It also drops support for 32-bit Linux and removes the deprecated aioredis integration.
v3.19.110 fixesThis release focuses heavily on stability and correctness, fixing critical memory safety issues in IAST, resolving severe inaccuracies in lock profiling, and patching several segmentation faults across the tracer. Support for older Tornado versions is deprecated.
v3.19.08 fixes5 featuresThis release introduces multi-run support for LLM Observability experiments and fixes several performance issues related to profiling and CI Visibility tag fetching. Several attributes on ExperimentResult are deprecated in favor of the new .runs attribute.
v4.0.0Breaking4 featuresThis major release introduces significant API breaking changes, removes support for Python 3.8 and 32-bit Linux, and adds an OpenFeature provider implementation. It also updates default tracing behavior for Django and removes several deprecated integrations and configuration methods.
v4.0.0rc3Breaking4 featuresThis major release introduces significant backwards-incompatible API changes, drops support for Python 3.8 and 32-bit Linux, and adds an OpenFeature provider implementation. Users should review breaking changes carefully, especially regarding removed APIs and updated Django tracing defaults.
v3.19.0rc18 fixes5 featuresThis release introduces multi-run LLM experiments and security response IDs, alongside several bug fixes addressing performance issues related to profiling and CI Visibility. Several attributes on ExperimentResult and the Span.finished setter are deprecated.
v4.0.0rc2Breaking1 fix7 featuresThis major release introduces significant breaking changes, including the removal of Python 3.8 support and deprecated APIs, while adding new features like OpenFeature provider support and enhanced LLM Observability capabilities.
v4.0.0rc1Breaking4 fixes6 featuresThis major release introduces significant API breaking changes, including the removal of Python 3.8 support, deprecated methods, and configuration variables. New features focus on AAP, profiling enhancements, and LLM Observability updates, while Django tracing defaults to a minimal mode.
v3.18.13 fixesThis release focuses on bug fixes across CI Visibility, LLM Observability, and Error Tracking, including performance improvements and stability enhancements.
v3.18.023 fixes5 featuresThis release introduces new features for API Security in AWS Lambda and enhanced lock profiling, alongside numerous bug fixes across integrations like LangChain, Ray, and OpenAI. Several older tracing span methods and the V1 stack profiler are deprecated in preparation for version 4.0.0.
v3.17.36 fixesThis release focuses on bug fixes across CI Visibility, LLM Observability, OpenTelemetry integration, Ray support, and general tracer stability, including improved compatibility with zope.event 6.0.
v3.18.0rc224 fixes5 featuresThis release introduces new features for API Security and LLM Observability, enhances profiling with RLock support, and resolves numerous bugs across integrations like LangChain, Ray, and OpenAI, while deprecating several older span tagging methods.
v3.18.0rc120 fixes5 featuresThis release introduces new features for API Security in AWS Lambda and enhanced LLM Observability dataset management, alongside numerous bug fixes across integrations like Kafka, LangChain, OpenAI, and Ray. Several older tracing and profiling methods are deprecated in preparation for v4.0.0.
v3.16.44 fixesThis release focuses on bug fixes across tracing, logging, and language detection, including resolving an issue with prompt template instrumentation and fixing a race condition in the tracer.
v3.17.26 fixesThis release focuses on stability, fixing several bugs across integrations like langchain and openai, and resolving internal logging issues related to trace-log correlation.
v3.16.33 fixesThis release focuses on bug fixes across CI Visibility, LLM Observability, and profiling components, including performance improvements for Python 3.12+ coverage collection and fixes for memory allocation and infinite loops in the profiler.
v3.17.16 fixesThis release focuses on bug fixes across CI Visibility, LLM Observability, IAST, and profiling, including performance improvements and stability fixes for newer Python versions.
v2.21.121 fixThis release primarily addresses a dependency constraint by pinning 'wrapt' to version <2 until compatibility issues are resolved.
v3.17.012 fixes12 featuresThis release introduces significant new features for LLM Observability, including context propagation for asyncio tasks and support for storing experiments in different projects. It also deprecates several tracing utilities and support for Python 3.8.
v3.17.0rc112 fixes12 featuresThis release introduces significant new features for LLM Observability, including context propagation for asyncio tasks and support for storing experiments in different projects. It also deprecates several tracing utilities and support for Python 3.8.
v3.15.13 fixesThis release focuses on stability by pinning the `wrapt` dependency and fixing specific bugs related to CI test visibility and langchain patching compatibility.
v3.16.21 fixThis release focuses on stabilizing dependencies by pinning `wrapt` to an older version to avoid immediate compatibility issues.
v3.16.17 fixesThis release focuses primarily on bug fixes across CI Visibility, gRPC, Ray integrations, and internal module unloading issues. It also includes a tentative fix for rare memory problems in AAP.
v3.16.08 fixes3 featuresThis release introduces Python 3.14 compatibility updates and new features for OpenTelemetry metrics and Ray tracing, alongside several bug fixes, particularly for LLM Observability and CI Visibility.
v3.16.0rc28 fixes3 featuresThis release introduces Python 3.14 compatibility for core library injection and adds features like Ray tracing integration and OpenTelemetry metrics defaults. Several key integrations remain incompatible with Python 3.14 pending upstream dependency updates.
v3.16.0rc17 fixes3 featuresThis release introduces Python 3.14 compatibility updates and adds new features for OpenTelemetry Metrics and Ray tracing, alongside several bug fixes across integrations.
v3.15.014 fixes13 featuresThis release introduces significant new observability features across Google ADK, Django (minimal tracing mode), AWS tagging, and LLM Observability enhancements. Numerous bug fixes address stability issues in profiling, exception replay, and CI Visibility metrics.
v3.14.43 fixesThis release focuses on bug fixes across AAP and CI Visibility components, addressing issues related to asyncio errors in streaming endpoints and incorrect metric aggregation for ITR skip counts.
v3.15.0rc114 fixes12 featuresThis release introduces significant observability enhancements across various libraries including Google ADK, Django (with minimal tracing option), AWS, and AAP. It also includes crucial bug fixes related to profiling stability, exception replay, and CI Visibility metrics.
v3.14.33 fixesThis release focuses on bug fixes across exception replay, tracing, and libinjection modules, ensuring better stability and handling of custom exceptions and byte string encoding.
v3.13.42 fixesThis release includes bug fixes related to byte string encoding in tracing spans and improved deny listing capabilities in libinjection for modules executed via \`python -m\`.
v3.12.91 fixThis release includes a bug fix for libinjection related to denying python modules executed via `python -m` and denying `py_compile`.
v3.14.23 fixesThis release focuses on bug fixes, including improvements to sampling stability, dynamic instrumentation, and source code integration checks. The estimated end-of-life is September 2026.
v3.13.33 fixesThis release focuses on bug fixes, including improvements to sampling logic, source code integration robustness, and CI Visibility coverage submission for pytest-xdist sessions.
v3.12.82 fixesThis release primarily focuses on bug fixes, including improvements to exception replay for Celery tasks and safer handling of source code integration environment variables.
v3.14.11 fixThis release primarily addresses a bug in the AAP component by disabling grpc threat monitoring to prevent false positives. It also provides an updated end-of-life estimate.
v3.14.010 fixes4 featuresThis release introduces AI Guard support for LangChain, makes `ml_app` optional for LLM Observability, and includes numerous bug fixes across AAP, Django, asyncpg, exception replay, and CI Visibility.
v3.13.21 fixThis release primarily addresses a bug in the tracing component related to the __repr__ method of SpanPointer objects. It also provides an updated end-of-life estimate.
v3.12.71 fixThis release primarily addresses a bug in the tracing component related to the __repr__ method of SpanPointer objects. It also provides an updated end-of-life estimate.
v3.14.0rc210 fixes4 featuresThis release introduces AI Guard support for LangChain and enhances LLM Observability by making `ml_app` optional and adding tool definition support to annotations. Numerous bug fixes address issues across AAP, Django, asyncpg, exception replay, and CI Visibility.
v3.13.11 fixThis release primarily addresses a bug in the Django integration related to coroutine execution on Python 3.13+.
v3.14.0rc16 fixes3 featuresThis release introduces AI Guard support for LangChain and enhances LLM Observability by making `ml_app` optional and adding tool definition annotation capabilities. Several bug fixes address issues in asyncpg, exception replay, LLM observability, and CI Visibility.
v3.13.013 fixes11 featuresThis release introduces significant new features for LLM Observability across multiple integrations (Bedrock, GenAI, OpenAI, VertexAI) and adds experimental OTLP log exporting support via OpenTelemetry. It also includes several bug fixes, notably around websocket span closing and sampling rules, and deprecates ddtrace.tracer.Pin.
v3.12.61 fixThis release primarily addresses a bug in CI Visibility related to coverage submission when using pytest-xdist, ensuring proper Test Impact Analysis functionality.
v3.12.51 fixVersion 3.12.5 fully aligns all updates previously missing in patch releases 3.12.1 through 3.12.4, including a critical fix for the memory profiler's CPU consumption.
v3.12.41 fixThis release primarily addresses a bug fix in the tracing integration for asyncpg connections when custom connect options are used.
v3.13.0rc113 fixes11 featuresThis release introduces significant LLM Observability enhancements for tool usage across multiple integrations (Bedrock, GenAI, OpenAI, VertexAI) and adds experimental OTLP log exporting support. It also deprecates `ddtrace.tracer.Pin` and includes numerous bug fixes across tracing, AAP, and sampling.
v3.12.33 fixesThis release focuses on bug fixes across ASGI websocket tracing, SSI/Crashtracker script loading, and tracer flare configuration.
v3.10.43 fixesThis release focuses on bug fixes across CI Visibility, psycopg, and Code Security (IAST) to improve stability and compatibility with specific testing patterns and Python's eval() function.
v3.11.46 fixesThis release focuses on bug fixes across several integrations, including CI Visibility, psycopg, openai, and LLM Observability components like google-genai and langgraph.
v3.12.22 fixesThis release focuses on bug fixes, specifically addressing memory leaks in the CI Visibility pytest plugin and resolving a circular import in the psycopg3 contrib.
v3.12.12 fixes1 featureThis release fixes bugs related to OpenAI error handling and LLM Observability tag parsing, and adds URL origin override capability to LLM Observability.
v3.12.017 fixes10 featuresThis release introduces the technical preview of the AI Guard Python SDK, adds experimental CI Visibility writer separation, and enhances LLM Observability tracing across several integrations. Several deprecations are noted, including the removal of Windows profiling support and the deprecation of `ddtrace.settings.__init__` imports.
v3.12.0rc3Breaking17 fixes10 featuresThis release introduces the technical preview of the AI Guard Python SDK, enhances LLM Observability tracing across several frameworks, and removes Windows support for profiling. Several bug fixes address issues in AAP, tracing sampling consistency, and various integrations like Kafka and OpenAI.
v3.12.0rc218 fixes9 featuresThis release introduces the technical preview of the AI Guard Python SDK and adds significant features to LLM Observability and CI Visibility, while removing Windows support for profiling and deprecating older tracing initialization methods.
v3.11.38 fixesThis release focuses on numerous bug fixes across various integrations, including AAP, Kafka, OpenAI, and tracing, improving stability and correctness, especially around exception handling and trace sampling.
v3.12.0rc118 fixes7 featuresThis release introduces the technical preview of the AI Guard Python SDK, enhances LLM Observability with increased limits and LangGraph support, and fixes numerous bugs across tracing, CI Visibility, and integrations. Windows profiling support has been removed.
v3.11.21 fixThis release primarily addresses a bug in CI Visibility related to how pytest skipif markers interact with other pytest plugins. The estimated end-of-life date is August 2026.
v3.11.11 fixThis release primarily addresses a bug in the ddtrace_api integration related to calling patch() or patch_all() without arguments.
v3.11.023 fixes16 featuresThis release introduces significant new features for LLM Observability across various frameworks (Anthropic, Bedrock, Google GenAI, OpenAI) and enhances tracing support for Django and MCP. Several bug fixes address issues related to CI Visibility test reporting, LLM token counting accuracy, and instrumentation stability.
v2.21.113 fixesThis release focuses on improving dynamic instrumentation stability, fixing issues related to generator instrumentation on Python 3.10 and iteration block handling.
v3.10.36 fixesThis release focuses on stability and correctness, introducing several bug fixes across dynamic instrumentation, tracing decorators, AST analysis robustness, LLM observability metadata handling, and Django ORM span tagging.
v3.11.0rc323 fixes16 featuresThis release introduces significant new features across LLM Observability, AAP endpoint discovery, and experimental OTLP metrics export. It also includes numerous bug fixes, particularly addressing tracing and token counting issues in LLM integrations, and deprecates the `freezegun` integration for CI Visibility.
v3.11.0rc226 fixes13 featuresThis release introduces extensive LLM Observability features, including token caching tracking for Anthropic and Bedrock, and automatic tracing for Google GenAI calls. It also fixes numerous bugs across CI Visibility, LLM tracing, and core tracing functionality, while deprecating the `freezegun` integration.
v2.21.105 fixesThis release focuses on stability and correctness, primarily fixing several bugs related to tracing data encoding, truncation limits for span attributes, and dynamic instrumentation compatibility.
v3.11.0rc126 fixes13 featuresThis release introduces significant new features for LLM Observability across various providers (Anthropic, Bedrock, Google GenAI, OpenAI) and adds experimental support for OTLP metrics export. Several bug fixes address tracing accuracy, LLM token counting, and integration stability, while the \`freezegun\` integration is deprecated.
v3.10.21 fixThis release primarily addresses a bug in logging where DD properties were not correctly injected for non-structured loggers, regardless of the environment variable setting.
v3.10.13 fixesThis release primarily focuses on bug fixes related to CI Visibility, ensuring correct test result reporting when using external retry plugins or pytest-xdist, and resolving broken span links in LLM Observability for recent LangGraph versions.
v3.10.024 fixes19 featuresThis release introduces significant new features across LLM Observability, Dynamic Instrumentation, and CI Visibility, alongside numerous bug fixes for tracing stability and generator handling. Several environment variables and method arguments have been deprecated.
v3.10.0rc31 fix2 featuresThis release introduces LLM Observability features, specifically tracing support for PydanticAI methods, and resolves a bug related to generator instrumentation on Python 3.10.
v3.10.0rc28 fixes4 featuresThis release introduces tracing support for Google GenAI and Azure Service Bus, alongside several bug fixes for tracing generators, logging context, and dynamic instrumentation. Deprecation warnings have been issued for arguments in `record_exception`.
v3.10.0rc1Breaking15 fixes12 featuresThis release introduces significant feature enhancements across LLM Observability, Dynamic Instrumentation, and CI Visibility, alongside bug fixes for tracing and generator handling. Notably, the legacy Python profiler exporter has been removed, defaulting to the native exporter.
v3.9.45 fixesThis release focuses on bug fixes across several components including AAP, Tracing, LLM Observability, and Dynamic Instrumentation, addressing issues like unexpected security activity, encoding errors, and instrumentation failures.
v3.9.33 fixesThis release focuses on bug fixes across several components including Algoliasearch, Tracing, and AAP, resolving issues related to exceptions and user tracking inconsistencies.
v3.9.21 fixThis release primarily addresses a subtle bug in generator tracing that affected stack unwinding during exception handling by correcting the generator wrapping mechanism.
v3.9.11 fixThis release primarily addresses a bug in LLM Observability related to incorrect trace ID export.
v3.9.014 fixes12 featuresThis release introduces significant new features across DSM, Azure Functions, Code Security (IAST), CI Visibility, AAP, LiteLLM, and LLM Observability, alongside numerous bug fixes for tracing stability and LLM integrations. Support for DD_TRACE_GLOBAL_TAGS and legacy App Analytics has been deprecated/removed.
v3.9.0rc21 fixThis release primarily focuses on fixing an observability bug where LLM interactions were not being traced correctly when custom base URLs were configured for several major LLM providers.
v2.21.95 fixesThis release focuses primarily on bug fixes across several subsystems including CI Visibility, Dynamic Instrumentation, Kafka integration, Profiling, and Tracing, addressing issues like incorrect file lookups, performance overhead, configuration handling, and sampling logic.
v3.9.0rc14 fixes2 featuresThis release introduces CI Visibility features and tracing support for Azure Service Bus triggers, alongside several bug fixes related to generator wrapping and performance overhead. A new configuration option for safer instrumentation is also added.
v3.8.12 fixesThis release focuses on bug fixes, specifically addressing issues in CI Visibility related to tag pushes in GitHub actions and correcting an upload scope limitation in Dynamic Instrumentation.
v3.8.012 fixes5 featuresThis release introduces significant new features across LLM Observability, Error Tracking, and CI Visibility, alongside numerous bug fixes addressing stability, performance, and tracing issues.
v3.7.22 fixesThis release focuses on bug fixes, specifically addressing an issue with CI Visibility configuration and improving UTF-8 character counting during span attribute truncation in tracing.
v3.8.0rc31 fix1 featureThis release introduces a new processor capability for LLM Observability to process span inputs and outputs, and fixes a bug related to UTF-8 character counting during span attribute truncation.