newrelic 12.0.0

v12.0.0

on Python PyPI

Notes

This release of the Python agent removes support for Cross Application Tracing (CAT), Python 3.8, and the bundled SSL certificates. It also updates all vendored packages to their latest versions, and adds support for free-threaded CPython, Windows operating systems, and improved instrumentation for Microsoft AG2 (Autogen). Additionally, this release includes a new optional extra for installing SSL certificates through certifi. This release also fixes a bug in Strands Agents instrumentation which caused duplicate exceptions to be reported.

Install the agent using easy_install/pip/distribute via the Python Package Index, using conda via the Conda-Forge Package Index, or download it directly from the New Relic download site.

Removed features

• Cross Application Tracing (CAT) has been removed in favor of Distributed Tracing (DT).

  • Cross Application Tracing (CAT) was deprecated in agent version 7.0.0.166, and has been removed in this release. If you are still using Cross Application Tracing (CAT), we recommend migrating to Distributed Tracing (DT) as soon as possible to avoid disruption.

• The bundled SSL certificates have been removed.

  • If you require certificates for your environment, you can either install them via your operating system's package manager or install the agent with the optional newrelic[certificates] extra.

• Python 3.8 support has been removed.

  • Python 3.8 reached End-of-Life on 2024-10-07 and is no longer supported by the agent. Please consider upgrading your application to a supported version of Python in order to continue to receive updates to the Python Agent.

Security

• All internal packages updated to their latest versions.

  • urllib3 updated to v2.6.3
    • This fixes all open CVEs on urllib3 as of the date of this release.
  • opentelemetry_proto updated to v1.40.0
  • wrapt updated to v2.1.2
  • asgiref updated to v3.11.1

New features

• New newrelic[certificates] extra for installing SSL certificates through certifi.

  • The agent now provides an optional newrelic[certificates] extra which can be used to install the bundled SSL certificates. This is intended for users who require certificates but are unable to install them via their operating system's package manager.

• Free-Threaded CPython support

  • Starting with Python 3.13, CPython releases builds of Python with the Global Interpreter Lock (GIL) disabled, allowing for true multi-threading.
  • This release adds support for this behavior, allowing the agent to safely run in a free-threaded environment.
  • This release also includes pre-built binaries for free-threaded CPython on Linux and Windows, allowing for easy installation in these environments.

• Windows Support

  • This release includes pre-built binaries for CPython 3.13 or higher on Windows.
  • Note that Python 3.12 or lower is not officially supported on Windows due to large variances in the resolution of timers. It's still possible to install and use the agent from source, but users may experience issues with inaccurate timing data and should upgrade to Python 3.13 or higher for the best experience.

• Improved instrumentation for Microsoft AG2 (Autogen)

  • Added support for streaming responses through the asynchronous generator method on_messages_stream().
  • Instrumentation now includes a subcomponent attribute on spans that represent tool or agent calls. This is used to provide more enhanced entity mapping in the New Relic UI.

Bugs

• Duplicate exceptions in Strands Agents

  • After an update to Strands Agents which encapsulates some exceptions in a new EventLoopException type, duplicate errors could be reported. This has been fixed and the underlying error should only be reported once.

Support statement

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date.

See the New Relic Python agent EOL policy for information about agent releases and support dates.