Change8

Datadog SDK

Backend & Infra

Datadog Python APM Client

Latest: v4.7.1100 releases7 breaking changes4 common errorsView on GitHub

Release History

v4.7.13 fixes
Apr 14, 2026

This release focuses on stability by fixing rare crashes related to internal threading, especially in forking environments like Gunicorn, and resolves data loss issues in CI Visibility when using pytest-xdist.

v4.6.82 fixes
Apr 14, 2026

This release focuses on stability by fixing rare crashes related to internal threads during process forking or Python shutdown.

v4.5.101 fix
Apr 14, 2026

This release primarily addresses a rare crash issue related to internal periodic threads during forking.

v4.8.0rc415 fixes10 features
Apr 13, 2026

This release introduces significant new features across profiling, tracing (Azure CosmosDB, MySQL async, OTLP export), and LLM Observability (LlamaIndex support, Remote Config). It also removes support for the RAGAS integration and deprecates several configuration parameters.

v4.7.018 features
Apr 10, 2026

This release introduces significant performance improvements to profiling via Cython compilation and adds extensive new features across MLFlow, AI Guard, Azure Durable Functions, and deep enhancements to LLM Observability, including Pydantic evaluation support and incremental experiment reporting. Process tags are now propagated across many components by default.

v4.5.92 fixes
Apr 10, 2026

This release addresses critical stability issues related to application forking and Python shutdown, and resolves data loss for buffered test events in CI Visibility when using pytest-xdist.

v4.8.0rc313 fixes7 features
Apr 9, 2026

This release introduces new integrations for Azure CosmosDB, LiteLLM proxy guardrails, and LlamaIndex, alongside significant bug fixes for profiling, LLM Observability span hierarchy, and CI Visibility stability. Support for the RAGAS integration has been removed.

v4.8.0rc212 fixes7 features
Apr 8, 2026

This release introduces new tracing support for Azure CosmosDB and llama-index, adds an AI Guardrail integration for LiteLLM, and fixes several bugs related to profiling, internal thread leaks, and LLM Observability span reporting.

v4.6.72 fixes
Apr 8, 2026

This release includes bug fixes for LLM Observability span hierarchy and CI Visibility test event loss during pytest-xdist crashes. Users can enable eager flushing for the latter via an environment variable.

v4.7.0rc51 fix23 features
Apr 7, 2026

This release significantly enhances LLM Observability features, introduces AI Guard integration for AWS Strands Agents, and optimizes profiling performance via Cython compilation. Several components now propagate process tags for better context.

v4.8.0rc17 fixes6 features
Apr 7, 2026

This release introduces new tracing support for Azure CosmosDB, an AI Guard integration for LiteLLM, and OTLP export capabilities. It also removes the deprecated RAGAS integration for LLM Observability.

v4.5.82 fixes
Apr 7, 2026

This release focuses on stability in fork-heavy environments by fixing an internal thread leak and a post-fork crash.

v4.6.63 fixes
Apr 7, 2026

This release focuses on stability by fixing bugs related to client side stats tags and addressing potential thread leaks and crashes in fork-heavy applications.

v4.7.0rc41 fix23 features
Apr 1, 2026

This release significantly enhances LLM Observability with new features like Pydantic evaluation support, remote evaluators, and reasoning capture. It also introduces process tag propagation across several components and updates dependencies for OpenFeature.

v4.6.53 fixes
Apr 1, 2026

This release focuses on bug fixes, particularly improving resilience for CI Visibility data uploads under rate limiting and resolving issues with periodic thread execution in forked processes and stack profiling on Linux with unlimited stack size.

v4.5.73 fixes
Apr 1, 2026

This release focuses on bug fixes, particularly addressing rate-limiting handling for CI Visibility data and resolving startup issues for profiling threads under specific conditions (forking or unlimited stack size).

v4.7.0rc31 fix23 features
Mar 31, 2026

This release introduces significant new features across LLM Observability, AI Guard integration with AWS Strands Agents, and tracing for Azure Durable Functions. It also optimizes the lock profiler via Cython compilation and propagates process tags across various monitoring payloads.

v4.7.0rc227 features
Mar 25, 2026

This release introduces significant performance improvements to the profiler via Cython compilation and adds extensive new features across LLM Observability, tracing integrations (MLFlow, Azure Durable Functions, Google Cloud Pub/Sub), and general telemetry propagation via process tags.

v4.6.41 fix
Mar 25, 2026

This release primarily addresses a bug in LLM Observability where the @llm decorator failed on certain return types, now logging a debug message instead. Compatibility information regarding support levels is also provided.

v4.6.33 fixes1 feature
Mar 24, 2026

This release focuses on LLM Observability improvements, making size limits configurable via environment variables and fixing serialization issues for nested Pydantic models and return values in @llm decorated functions.

v4.6.23 fixes
Mar 23, 2026

This release focuses on stability and correctness, fixing crashes related to Git metadata handling in CI Visibility and thread management during shutdown. It also unifies trace generation for LLM Observability spans.

v4.5.65 fixes
Mar 23, 2026

This release focuses on stability and correctness, fixing several bugs related to CI Visibility, LLM Observability, thread safety during process forks, and memory profiling accuracy.

v4.6.18 fixes
Mar 19, 2026

This release focuses on numerous bug fixes across CI Visibility, LLM Observability, tracing, and profiling components. Key fixes include resolving conflicts with external pytest plugins and preventing crashes during process shutdown.

v4.5.54 fixes
Mar 18, 2026

This release focuses primarily on bug fixes across CI Visibility, ensuring correct behavior for pytest plugins and ITR tagging, and resolves a runtime error in the Tracing component.

v4.7.0rc111 fixes19 features
Mar 17, 2026

This release introduces significant feature enhancements across MLFlow integration, AI Guard, LLM Observability, and adds process tag propagation across many components. Several bug fixes address issues in CI Visibility, tracing context handling, and profiler stability.

v4.6.016 fixes15 features
Mar 16, 2026

This release introduces significant enhancements to LLM Observability, including experiment status reporting, DeepEval integration, and prompt management via `LLMObs.get_prompt()`. It also includes numerous bug fixes across Profiling, AI Guard, and tracing components, alongside a deprecation warning for a future type change in `Span.parent_id`.

v4.5.42 fixes
Mar 13, 2026

This release primarily focuses on bug fixes, including resolving an import-time TypeError in the profiling lock profiler related to PEP 604 type unions and fixing potential shutdown crashes.

v3.19.71 fix
Mar 13, 2026

This release addresses a critical memory corruption bug in the AAP component related to concurrent WAF calls by introducing context serialization. The estimated end-of-life date is August 2026.

v4.5.31 fix
Mar 10, 2026

This release primarily addresses a bug in LLM Observability related to token capture in the LiteLLM integration. It also provides an updated end-of-life estimate.

v4.6.0rc35 fixes4 features
Mar 9, 2026

This release introduces inferred proxy support for Azure API Management and enables stats computation by default for Python 3.14+. Several bug fixes address tracing propagation, profiler type compatibility, and race conditions in worker threads.

v4.5.21 fix
Mar 9, 2026

This release primarily focuses on stability by adding a timeout to Unix socket connections to prevent thread I/O hangs during pre-fork shutdown.

v4.5.12 fixes
Mar 5, 2026

This release focuses on stability, fixing critical memory corruption issues in the AAP component and resolving compatibility problems within CI Visibility reporting plugins.

v4.6.0rc25 fixes4 features
Mar 5, 2026

This release introduces significant enhancements to LLM Observability, including DeepEval integration and experiment summary logging, alongside critical bug fixes for AAP memory corruption and CI Visibility reporting compatibility.

v4.6.0rc13 fixes6 features
Feb 24, 2026

This release enhances LLM Observability by adding prompt retrieval, improved experiment span context, and dataset tagging capabilities. It also includes several bug fixes related to large dataset uploads and profiling initialization.

v4.5.013 fixes12 features
Feb 24, 2026

This release introduces significant new features for LLM Observability, including built-in evaluators and expanded provider support for LLM Judge. It also deprecates the explicit `tracer` parameter across several integrations in preparation for version 5.0.0.

v4.5.0rc413 fixes12 features
Feb 18, 2026

This release introduces significant new features for LLM Observability, including support for Claude Agent SDK tracing and new built-in evaluators. It also includes crucial bug fixes across profiling, tracing signal handling, and dependency injection.

v4.5.0rc312 fixes7 features
Feb 17, 2026

This release introduces significant new features for LLM Observability, including advanced evaluators and Judge capabilities, alongside support for Python 3.14 template strings in IAST. It also addresses numerous stability issues across profiling, tracing, and internal components, while deprecating the explicit `tracer` parameter in several integrations.

v4.5.0rc211 fixes7 features
Feb 12, 2026

This release introduces significant new features for LLM Observability evaluators and IAST support for Python 3.14 template strings, alongside numerous bug fixes in profiling and tracing signal handling. Several parameters related to tracer injection are deprecated in preparation for version 5.0.0.

v4.5.0rc18 fixes5 features
Feb 11, 2026

This release introduces significant new features for LLM Observability, IAST support for Python 3.14 template strings, and pymongo 4.12+ tracing. It also deprecates several parameters in tracing integrations in favor of the default tracer singleton and includes numerous bug fixes across profiling and tracing components.

v4.4.020 fixes6 features
Feb 5, 2026

This release introduces significant enhancements to LLM Observability with class-based evaluators and concurrent synchronous experiment execution. It also adds support for LFI detection and Tornado framework integration for AAP, alongside numerous bug fixes across profiling, exception replay, and various integrations.

v3.19.61 fix
Feb 4, 2026

This release primarily addresses a bug fix related to greenlet behavior during profiling when using `gevent.joinall`.

v4.4.0rc320 fixes7 features
Feb 2, 2026

This release introduces significant enhancements to LLM Observability with class-based evaluators and concurrent synchronous experiment execution. It also adds support for LFI detection and Tornado integration for AAP, alongside numerous bug fixes across profiling, exception replay, and various integrations.

v4.3.23 fixes
Jan 30, 2026

This release focuses on stability, addressing critical bugs in Celery integration, Data Streams Monitoring auto-enabling, and gevent profiling interactions.

v4.3.11 fix
Jan 29, 2026

This release primarily addresses a stability issue in profiling by fixing a crash related to memory profiling during forking.

v4.4.0rc213 fixes4 features
Jan 28, 2026

This release introduces significant enhancements to LLM Observability with class-based evaluators and adds configuration for logging levels via `DD_TRACE_LOG_LEVEL`. Numerous bug fixes address issues across profiling, AWS Lambda handlers, gevent compatibility, and specific library integrations like litellm and pydantic-ai.

v4.3.014 fixes6 features
Jan 27, 2026

This release introduces new profiling capabilities for threading conditions and asyncio task relationships, enhances LLM Observability, and enables WebSocket tracing by default for ASGI. It also mandates an upgrade for the minimum supported `httpx` version to 0.25.0 and fixes several stability and correctness issues across profiling and integrations.

v4.4.0rc18 fixes3 features
Jan 27, 2026

This release introduces significant enhancements to LLM Observability with class-based evaluators and fixes several critical bugs across AAP, aws_lambda, exception replay, litellm integration, and profiling.

v4.2.31 fix
Jan 26, 2026

This release primarily addresses a rare bug related to process hanging upon fork during profiling. It also provides an update on the estimated end-of-life date.

v4.2.24 fixes
Jan 22, 2026

This release focuses on bug fixes across LLM Observability integrations (langchain, litellm) and profiling, addressing issues with span duplication, stream handling errors, and incorrect flamegraph rendering.

v4.3.0rc114 fixes6 features
Jan 21, 2026

This release introduces significant enhancements to profiling, LLM Observability, and security analysis via AAP, while also increasing the minimum required version for the httpx dependency. Several critical bugs related to profiling stability and Django UUID tagging have been resolved.

v4.1.45 fixes
Jan 14, 2026

This release focuses on bug fixes across profiling, LLM Observability, and the Anthropic integration, including resolving issues related to lock subclassing, asyncio race conditions, and multiprocessing pickling on Python 3.14+.

v4.0.43 fixes
Jan 14, 2026

This release focuses on bug fixes across LLM Observability and profiling, addressing issues with trace ID propagation, lock subclassing errors, and asyncio task stack reporting.

v3.19.52 fixes
Jan 13, 2026

This release primarily focuses on bug fixes, addressing an evaluation error in dynamic instrumentation and a TypeError during profiling of subclassed locks.

v4.2.12 fixes
Jan 12, 2026

This release focuses on bug fixes, specifically addressing issues in LLM Observability tracing for the anthropic beta client and improving profile accuracy for off-CPU asyncio Tasks.

v4.2.0
Jan 9, 2026
v4.2.0rc321 fixes17 features
Jan 8, 2026

This 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 features
Jan 8, 2026

This 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 fixes
Jan 8, 2026

This release focuses primarily on bug fixes across SSI, LLM Observability, and profiling, improving stability, context management, and stack accuracy.

v4.0.34 fixes
Jan 7, 2026

This 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 fixes
Jan 7, 2026

This 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 features
Jan 6, 2026

This 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 fixes
Jan 5, 2026

This 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 fix
Dec 26, 2025

This 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 fixes
Dec 19, 2025

This 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 features
Dec 18, 2025

This 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 features
Dec 17, 2025

This 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 features
Dec 16, 2025

This 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 fix
Dec 16, 2025

This release primarily focuses on stability improvements by resolving a potential deadlock issue within the tracing mechanism.

v4.0.19 fixes
Dec 16, 2025

This 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 fix
Dec 16, 2025

This release primarily focuses on improving the reliability of span parsing within the Profiling feature.

v4.1.0rc1Breaking13 fixes28 features
Dec 15, 2025

This 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 fixes
Dec 12, 2025

This 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 features
Nov 21, 2025

This 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 features
Nov 20, 2025

This 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 features
Nov 20, 2025

This 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 features
Nov 18, 2025

This 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 features
Nov 14, 2025

This 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 features
Nov 13, 2025

This 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 fixes
Nov 7, 2025

This release focuses on bug fixes across CI Visibility, LLM Observability, and Error Tracking, including performance improvements and stability enhancements.

v3.18.023 fixes5 features
Nov 5, 2025

This 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 fixes
Nov 5, 2025

This 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 features
Nov 4, 2025

This 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 features
Nov 3, 2025

This 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 fixes
Oct 29, 2025

This 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 fixes
Oct 29, 2025

This 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 fixes
Oct 28, 2025

This 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 fixes
Oct 27, 2025

This 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 fix
Oct 24, 2025

This release primarily addresses a dependency constraint by pinning 'wrapt' to version <2 until compatibility issues are resolved.

v3.17.012 fixes12 features
Oct 23, 2025

This 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 features
Oct 21, 2025

This 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 fixes
Oct 21, 2025

This 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 fix
Oct 21, 2025

This release focuses on stabilizing dependencies by pinning `wrapt` to an older version to avoid immediate compatibility issues.

v3.16.17 fixes
Oct 17, 2025

This 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 features
Oct 9, 2025

This 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 features
Oct 7, 2025

This 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 features
Oct 7, 2025

This 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 features
Sep 26, 2025

This 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 fixes
Sep 25, 2025

This 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 features
Sep 24, 2025

This 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 fixes
Sep 23, 2025

This release focuses on bug fixes across exception replay, tracing, and libinjection modules, ensuring better stability and handling of custom exceptions and byte string encoding.

Common Errors

NotImplementedError1 report

NotImplementedError usually arises when a function or method is declared but lacks an actual implementation in a subclass or abstract base class, particularly with newer Python versions or libraries that might have added features. To resolve this, identify the method raising the error (e.g., a `Pathlib` method) and provide a concrete implementation in your subclass or use a compatible library version that fully supports the function. Alternatively, monkey-patch the missing implementation if direct modification is not possible.

TypeError1 report

TypeError errors in the datadog-sdk often arise from inconsistencies in expected data types, especially booleans, when setting configuration options like `DD_PROFILING_ENABLED`. To resolve this, ensure environment variables meant to represent booleans (True/False) are explicitly parsed as booleans before being used by the Datadog SDK. Specifically, check if `os.environ.get('DD_PROFILING_ENABLED')` is interpreted as a string instead of a boolean; if so, use code like `DD_PROFILING_ENABLED = os.environ.get('DD_PROFILING_ENABLED', 'false').lower() == 'true'` to cast the environment variable value to a proper boolean within your application.

AttributeError1 report

This AttributeError usually arises when code tries to access a non-existent attribute of an object, often due to version incompatibilities or incorrect class/module usage. To fix it, verify that the attribute genuinely exists in the object's class for the Python version you're using. If the attribute is missing in the current environment, either update the relevant library to a compatible version or use conditional logic to provide a fallback for older versions.

FileNotFoundError1 report

FileNotFoundError in datadog-sdk, especially with temporary directories, often arises when the user running the application lacks permissions or the designated temporary directory is missing or invalid. Resolve this by ensuring the user has read/write access to the temporary directory (e.g., /tmp), or by explicitly setting the TMPDIR, TEMP, or TMP environment variables to a valid, accessible directory before running your application.

Related Backend & Infra Packages

Subscribe to Updates

Get notified when new versions are released

RSS Feed