●Change8

Migrating to Datadog SDK v4.12.0

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

Released: 7/24/2026

1
Breaking Changes
1
Migration Steps
21
Affected Symbols

⚠️ Check Your Code

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

ddtrace.testingLLMObs.annotateLLMObs.enableLLMObs.register_processorSyncExperiment.rerun_evaluatorsOpenAI chat.completionsOpenAI completionsOpenAI responsesAzure OpenAImistralai clientpytorch.rankinit_process_groupdestroy_process_groupDeploymentHandle.remote()aws.durable.stepaws.durable.wait_for_conditionhttp.routeserver.business_logic.llm.eventappsec.events.llm.call.providerappsec.events.llm.call.modelAIGuardAbortError

Breaking Changes

●Issue #1

The APM trace writer now uses the `v0.4` trace API version when both APM and LLMObs are enabled, as `v0.5` cannot carry 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.

Migration Steps

  1. 1
    Upgrade libddwaf to 2.0.0 for ASM.

Release Summary

This release introduces significant enhancements to AI Guard, LLM Observability, and AppSec, including new features for handling audio, improving evaluation, and detecting LLM usage. It also brings instrumentation support for Ray Serve and Mistral AI, along with profiling improvements and bug fixes.

Need More Details?

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

View Full Changelog