●Change8

Migrating to Datadog SDK v4.8.0rc5

Version v4.8.0rc5 introduces 2 breaking changes. This guide details how to update your code.

Released: 4/23/2026

2
Breaking Changes
3
Migration Steps
14
Affected Symbols

⚠️ Check Your Code

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

claude_agent_sdkrayFastAPIStarlettegoogle_cloud_pubsubLLMObsExperimentRunddtrace.llmobs._writeranthropicopenaibotocoreddtrace.internal.process_tagsrq.job.Jobtornado

Breaking Changes

●Issue #1

Tool span resource names for claude_agent_sdk have changed from the tool name (e.g. `Read`, `Bash`) to `claude_agent_sdk.tool`. Users relying on the old resource name format must update their expectations to include `.tool` followed by the specific tool name (e.g., `claude_agent_sdk.tool.Read`).

●Issue #2

RQ integration compatibility: Replaced usage of the removed `Job.get_id()` with the `job.id` property in the RQ integration. Also, handling for `Job.get_status()` has changed; it now raises `InvalidJobOperation` for expired jobs instead of returning `None`.

Migration Steps

  1. 1
    Update code relying on `claude_agent_sdk` tool span resource names to expect the format `claude_agent_sdk.tool.<tool_name>` instead of just `<tool_name>`.
  2. 2
    If using RQ integration, update code to use `job.id` instead of `Job.get_id()`.
  3. 3
    If using RQ integration, handle potential `InvalidJobOperation` exceptions when calling status checks on expired jobs.

Release Summary

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

Need More Details?

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

View Full Changelog