●Change8

Migrating to New Relic SDK v12.0.0

Version v12.0.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 3/12/2026

2
Breaking Changes
3
Migration Steps
2
Affected Symbols

⚠️ Check Your Code

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

Microsoft AG2 (Autogen)on_messages_stream()

Breaking Changes

●Issue #1

Cross Application Tracing (CAT) has been removed. Users must migrate to Distributed Tracing (DT) to avoid disruption.

●Issue #2

The bundled SSL certificates have been removed. Users requiring certificates must install them via their OS package manager or use the `newrelic[certificates]` extra.

Migration Steps

  1. 1
    Migrate from Cross Application Tracing (CAT) to Distributed Tracing (DT).
  2. 2
    If you rely on bundled SSL certificates, install them via your operating system's package manager or install the agent with the optional `newrelic[certificates]` extra.
  3. 3
    Upgrade applications running on Python 3.8 to a supported version.

Release Summary

This release removes support for CAT and Python 3.8, updates vendored packages, and adds support for free-threaded CPython and Windows environments. It also introduces an optional extra for installing SSL certificates via certifi.

Need More Details?

View the full release notes and all changes for New Relic SDK v12.0.0.

View Full Changelog