●Change8

Migrating to Datadog SDK v4.12.0rc1

Version v4.12.0rc1 introduces 1 breaking change. This guide details how to update your code.

Released: 7/6/2026

1
Breaking Changes
5
Migration Steps
7
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

LLMObs.annotateLLMObs.enableLLMObs.register_processorSyncExperiment.rerun_evaluatorsDeploymentHandle.remoteinit_process_groupdestroy_process_group

Breaking Changes

●Issue #1

The APM trace writer now uses the `v0.4` trace API version when both APM and LLMObs are enabled because `v0.5` cannot carry the LLMObs span data. Setting `DD_TRACE_API_VERSION=v0.5` with LLMObs enabled will log a warning and downgrade to `v0.4`. No user action is required unless you explicitly set `DD_TRACE_API_VERSION=v0.5` and rely on v0.5 features.

Migration Steps

  1. 1
    If you rely on `DD_TRACE_API_VERSION=v0.5` while using LLMObs, be aware it will be downgraded to `v0.4` and log a warning.
  2. 2
    To enable buffered stream response evaluation for OpenAI or Anthropic streaming calls, set `DD_AI_GUARD_ANALYZE_STREAM_RESPONSES_ENABLED=true`.
  3. 3
    To disable AI Guard auto-instrumentation for OpenAI specifically, set `DD_AI_GUARD_OPENAI_ENABLED=false`.
  4. 4
    To enable PyTorch distributed training tracing, set `DD_PATCH_MODULES=pytorch:true`.
  5. 5
    To ensure the injected library takes precedence over user-installed ddtrace packages during Single Step Instrumentation, set `DD_INJECT_EXPERIMENTAL_OVERRIDE_USER_DDTRACE=true`.

Release Summary

This 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.

Need More Details?

View the full release notes and all changes for Datadog SDK v4.12.0rc1.

View Full Changelog