Datadog SDK
Backend & InfraDatadog Python APM Client
Release History
v3.19.8v4.11.0v4.12.0rc2v4.8.12v4.9.53 fixesThis release focuses on stability and reliability, fixing rare hangs in tracing after process forking and improving CI Visibility by resolving spurious git warnings and ensuring quarantined tests are retried.
v4.10.85 fixesThis release focuses on stability and observability improvements, fixing bugs related to threat protection reporting, process forking hangs, and ensuring correct span handling and rendering for various Gemini response types in LLM Observability.
v4.11.0rc76 fixesThis release focuses on stability and correctness, fixing memory leaks in database monitoring, resolving context extraction issues in SQS data streams, and ensuring proper handling of async middleware and process forking.
v4.10.73 fixesThis release focuses on stability, fixing a memory leak in database monitoring and resolving critical data extraction issues in SQS monitoring via botocore, alongside a Django middleware fix.
v4.12.0rc1Breaking1 fix24 featuresThis release introduces significant enhancements to AI Guard, LLM Observability (including audio support and sampling configuration), and adds tracing support for Ray Serve and Mistral AI client calls. It also includes bug fixes and infrastructure updates like a new normalized route tag for Tornado.
v4.9.42 fixesThis release focuses on stability, fixing an issue with thread restarts in forked children and resolving a rare crash on older CPython versions.
v4.10.65 fixesThis release focuses on stability and correctness in tracing, particularly for async generators across various Python versions, and resolves an issue with token reporting in LLM observability for streamed OpenAI completions.
v4.8.112 fixesThis release focuses on stability, fixing an issue with thread restarts in forked children and resolving a rare crash on older CPython versions.
v4.11.0rc52 fixesThis release primarily focuses on bug fixes, resolving a TypeError in async generator tracing on newer Python versions and correcting timeout handling for LLM Observability span writing.
v4.11.0rc47 fixesThis release focuses on stability and correctness across tracing, Celery integration, and LLM observability. Key fixes include resolving duplicate trace sending post-fork and ensuring correct metadata handling for LLM spans.
v4.10.53 fixesThis release focuses on stability and correctness, fixing critical bugs related to tracing duplication after forking and improving LLM observability by cleaning up metadata.
v4.9.32 fixesThis release focuses on stability improvements, specifically addressing issues related to process forking in tracing and profiling components.
v4.8.102 fixesThis release focuses on stability improvements, specifically addressing issues related to process forking in tracing and profiling components.
v4.11.0rc31 featureThis release introduces LLM Observability sampling control via the DD_LLMOBS_SAMPLE_RATE environment variable.
v4.9.23 fixesThis release focuses on stability and data completeness, fixing several crashes related to interpreter teardown and profiling, and ensuring accurate runtime metrics collection on cgroup v2 systems.
v4.10.45 fixesThis release focuses on stability and data integrity, fixing several bugs across LLM Observability, runtime metrics, IAST, profiling, and tracing components.
v4.11.0rc26 fixes2 featuresThis release enhances LLM Observability by enabling reliable export of span data over APM traces and fixes several bugs across tracing, IAST, and code origin features. A change in trace API versioning occurs when LLMObs is active.
v4.8.94 fixesThis release focuses on stability, addressing several crashes related to IAST, profiling, and pytest integration, while also improving runtime metric accuracy on cgroup v2 hosts.
v4.9.111 fixesThis release focuses heavily on stability and memory management, fixing numerous bugs across AppSec, tracing, LLM observability, and internal components like thread handling and garbage collection. Key fixes include resolving WebSocket connection failures and memory leaks.
v4.10.34 fixesThis release primarily focuses on stability and observability improvements, including increasing the default CI Visibility timeout, fixing APM span naming for pydantic integrations, and ensuring LLM Observability spans are not dropped due to deep JSON nesting.
v4.8.86 fixesThis release focuses primarily on stability and performance, addressing several memory leaks related to threading, profiling, and SCA, alongside fixes for recurring timer issues.
v4.10.25 fixesThis release focuses on stability and correctness, primarily addressing several bug fixes related to LLM Observability, tracing race conditions, and code origin inspection stability.
v4.11.0rc11 fix22 featuresThis release introduces significant enhancements for LLM Observability, API Security routing normalization, and improved profiling visibility on Python 3.12+. It also updates Flask instrumentation to expose more detailed resource information and enhances CI Visibility logging correlation.
v4.10.14 fixesThis release focuses primarily on stability and performance, addressing several memory leaks related to timers, thread callbacks, native frame tracking, and SCA updates.
v4.10.03 fixes1 featureThis release fixes critical bugs in AppSec WebSocket handling and LLM Observability streaming, and improves agentless LLMObs observability by bundling spans with APM traces.
v4.10.0rc11 featureLLMObs tracing now exports APM traces agentlessly when in agentless mode, consolidating span visibility in the UI for these users. Existing precedence rules for APM tracing remain in effect.
v4.9.0Breaking8 fixes14 featuresThis release introduces significant enhancements for LLM Observability, AI Guard integration, and CI Visibility, alongside fixing several critical bugs related to coverage and tracing instrumentation. A breaking change affects how HTTP status codes are reported for Azure CosmosDB spans.
v4.8.72 fixesThis release focuses on stability by fixing a critical tracing dependency issue related to wrapt and cleaning up unnecessary logs in LLM Observability when running agentless.
v4.8.61 fixThis patch resolves a bug in LLM Observability concerning Bedrock inference profiles in Langchain instrumentation, ensuring spans correctly reference the underlying model ID.
v4.8.54 fixesThis release focuses on bug fixes across LLM Observability integrations (Bedrock, OpenAI, Claude Agent SDK) and resolves a startup failure in Starlette when tracing is enabled. It also deprecates an old tracing environment variable.
v4.8.41 fixThis patch release fixes a bug in telemetry reporting related to malformed distribution metadata flooding stderr with tracebacks.
v4.8.3Breaking1 fixThis release updates Azure CosmosDB span tagging by replacing the http.status_code tag with the db.response.status_code metric, which constitutes a breaking change for users relying on the old tag.
v4.9.0rc2Breaking2 fixes2 featuresThis release introduces LLM Observability cost tagging and a configuration to exclude modules from lock profiling. It also fixes a startup deadlock related to Snowflake and resolves an issue with the lock profiler under gevent.
v4.7.212 fixesThis release focuses on stability and correctness across several areas, including fixing memory leaks in tracing, resolving crashes in profiling, and improving telemetry accuracy for AAP. LLM Observability span hierarchy and CI Visibility upload logic have also been corrected.
v4.8.25 fixesThis release fixes several issues related to header parsing limits for W3C tracestate and baggage, ensuring compliance with specifications and preventing unbounded work during extraction. It also resolves an import conflict affecting the Strands integration.
v4.8.12 fixesThis release focuses on stability, fixing a memory leak in tracing spans and correcting an issue where Django async operations were incorrectly marked as errors upon cancellation.
v4.8.0Breaking1 fix17 featuresThis release introduces significant new features across AI Observability (LLM, AI Guard, ASM), CI Visibility (Bazel offline support), and various integrations like Ray, Pub/Sub, and LlamaIndex. It also includes several breaking changes related to resource naming in claude_agent_sdk and Ray tracing configuration.
v4.9.0rc111 fixes2 featuresThis release introduces configuration for ignoring Ray actor methods, enhances AI Guard IP tagging, and fixes numerous bugs across CI Visibility, Django endpoint discovery, LLM Observability, and profiling stability.
v4.8.0rc5Breaking11 fixes12 featuresThis release introduces significant features for AI Observability (LLM Observability, AI Guard enhancements) and CI Visibility (Bazel offline support), alongside critical bug fixes and breaking changes to claude_agent_sdk span naming.
v4.7.13 fixesThis 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 fixesThis release focuses on stability by fixing rare crashes related to internal threads during process forking or Python shutdown.
v4.5.101 fixThis release primarily addresses a rare crash issue related to internal periodic threads during forking.
v4.8.0rc415 fixes10 featuresThis 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 featuresThis 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 fixesThis 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 featuresThis 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 featuresThis 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 fixesThis 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 featuresThis 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 featuresThis 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 fixesThis release focuses on stability in fork-heavy environments by fixing an internal thread leak and a post-fork crash.
v4.6.63 fixesThis 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 featuresThis 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 fixesThis 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 fixesThis 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 featuresThis 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 featuresThis 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 fixThis 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 featureThis 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 fixesThis 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 fixesThis 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 fixesThis 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 fixesThis 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 featuresThis 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 featuresThis 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 fixesThis 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 fixThis 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 fixThis 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 featuresThis 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 fixThis 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 fixesThis 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 featuresThis 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 featuresThis 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 featuresThis 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 featuresThis 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 featuresThis 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 featuresThis 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 featuresThis 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 featuresThis 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 fixThis release primarily addresses a bug fix related to greenlet behavior during profiling when using `gevent.joinall`.
v4.4.0rc320 fixes7 featuresThis 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 fixesThis release focuses on stability, addressing critical bugs in Celery integration, Data Streams Monitoring auto-enabling, and gevent profiling interactions.
v4.3.11 fixThis release primarily addresses a stability issue in profiling by fixing a crash related to memory profiling during forking.
v4.4.0rc213 fixes4 featuresThis 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 featuresThis 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 featuresThis 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 fixThis 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 fixesThis 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 featuresThis 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 fixesThis 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 fixesThis 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 fixesThis release primarily focuses on bug fixes, addressing an evaluation error in dynamic instrumentation and a TypeError during profiling of subclassed locks.
v4.2.12 fixesThis 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.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.
Common Errors
NotImplementedError1 reportNotImplementedError 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 reportTypeError 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 reportThis 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 reportFileNotFoundError 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
Production-Grade Container Scheduling and Management
Node.js JavaScript runtime ✨🐢🚀✨
Promise based HTTP client for the browser and node.js
A modern runtime for JavaScript and TypeScript.
Deliver web apps with confidence 🚀
Incredibly fast JavaScript runtime, bundler, test runner, and package manager – all in one
Subscribe to Updates
Get notified when new versions are released