Python agent release notesRSS

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.

Remarques

Cette version de l'agent Python ajoute la prise en charge des traces/spans pour Hybrid Agent, l'intégration de New Relic avec OpenTelemetry. Cela ajoute également des GUID d'entité aux fichiers de vérification de l'état d'Agent Control, des attributs subcomponent à l'instrumentation de l'IA agentique, la prise en charge de nouvelles méthodes client Redis, corrige un bug pouvant entraîner des instances ImportHookFinder en double et un bug dans l'instrumentation OracleDB Cursor.callproc().

Installez l'agent en utilisant easy_install/pip/distribute via l' index des packagesPython , en utilisant conda via l' index des packages Conda-Forge, ou téléchargez-le directement depuis le site de téléchargement de New Relic.

Caractéristiques

• Ajouter la prise en charge du tracing pour l'Agent hybride (Hybrid Agent)

  • L'agent hybride est conçu pour combler le fossé pour les équipes cherchant à adopter les normes OpenTelemetry tout en maintenant la rétrocompatibilité avec leurs dashboards New Relic existants. Hybrid Agent offre le « meilleur des deux mondes » en combinant la visibilité approfondie de New Relic avec la compatibilité de l'API OpenTelemetry. Il fournit une solution d'observabilité avec une prise en charge intégrée des API OpenTelemetry suivantes :

    • Tracé
    • Instrumentation de bibliothèques autonomes et de frameworks natifs

  • Des améliorations clés telles que les Span Links et les Events on Spans sont désormais disponibles, garantissant une interopérabilité transparente dans les environnements en mode mixte.

• Introduit un nouvel échantillonneur basé sur le ratio de Trace ID

  • Un nouvel échantillonneur basé sur le ratio d'ID de trace. Cet algorithme d'échantillonnage est basé sur l'échantillonneur du même nom d'OpenTelemetry et peut être configuré pour échantillonner un pourcentage défini de transactions.

• Ajouter subcomponent attributs à l'instrumentation de l'IA agentique

  • L'instrumentation pour LangChain, MCP et Strands inclut désormais un attribut subcomponent sur les spans représentant des appels d'outils ou d'agents. Ceci est utilisé pour fournir un mappage des entités amélioré dans l'interface utilisateur New Relic.

• Ajouter le GUID de l'entité aux fichiers de contrôle de santé d'Agent Control

  • Lorsque l'agent est démarré dans un environnement Agent Control, un fichier de bilan de santé est créé à l'emplacement de fichier configuré pour chaque processus de l'agent. Ce fichier inclut désormais le GUID de l'entité associée à l'agent lorsqu'il est disponible.

• Ajouter l'instrumentation pour les nouvelles méthodes Redis

  • Ajoutez l'instrumentation pour les nouvelles méthodes suivantes sur les clients Redis :

    • hotkeys_get
    • Réinitialiser les raccourcis
    • hotkeys_start
    • hotkeys_stop
    • vrange
    • xcfgset

Bugs

• Correction des instances ImportHookFinder en double

  • Auparavant, il était possible que des doublons du finder de hook d'importation soient ajoutés à sys.meta_path.

• Corriger la signature incorrecte sur OracleDB Cursor.callproc()

  • Auparavant, tenter d'utiliser des arguments nommés avec Cursor.callproc() provoquait des plantages car les noms d'arguments étaient incorrects dans notre instrumentation. Cela a été corrigé et l'argument supplémentaire keyword_parameters est désormais également pris en charge.

Déclaration de soutien

Nous vous recommandons de mettre à jour vers la dernière version de l'agent dès qu'elle est disponible. Si vous ne pouvez pas effectuer la mise à niveau vers la dernière version, mettez à jour vos agents vers une version datant de moins de 90 jours. En savoir plus sur la façon de tenir les agents informés.

Consultez la politique EOL de l'agent Python de New Relic pour obtenir des informations sur la sortie de l'agent et les dates de support.

Remarques

Cette version de l'agent Python ajoute la prise en charge des agents LangGraph.

Installez l'agent en utilisant easy_install/pip/distribute via l' index des packagesPython , en utilisant conda via l' index des packages Conda-Forge, ou téléchargez-le directement depuis le site de téléchargement de New Relic.

Caractéristiques

• Ajouter la prise en charge des agents LangGraph

  • Ajoute une instrumentation pour les invocations d'agents LangGraph via create_agent() dans LangChain. Cela inclut les appels de l'agent vers invoke(), ainvoke(), stream() et astream().

Déclaration de soutien

Nous vous recommandons de mettre à jour vers la dernière version de l'agent dès qu'elle est disponible. Si vous ne pouvez pas effectuer la mise à niveau vers la dernière version, mettez à jour vos agents vers une version datant de moins de 90 jours. En savoir plus sur la façon de tenir les agents informés.

Consultez la politique EOL de l'agent Python de New Relic pour obtenir des informations sur la sortie de l'agent et les dates de support.

Remarques

Cette version de l'agent Python ajoute de nouvelles façons de transmettre les erreurs à notice_error(), ajoute la prise en charge de la capture des erreurs d'outils synchrones Strands-Agent, ajoute la prise en charge de gpt-5 et des modèles OpenAI LLM plus récents, et corrige un plantage dans la logique d'utilisation d'Azure Functions.

Installez l'agent en utilisant easy_install/pip/distribute via l' index des packagesPython , en utilisant conda via l' index des packages Conda-Forge, ou téléchargez-le directement depuis le site de téléchargement de New Relic.

Caractéristiques

• Ajouter la prise en charge des instances d'exception comme arguments à notice_error()

  • notice_error() peut désormais accepter une instance d'exception interceptée (telle qu'une instance provenant d'un bloc try/except) pour l'argument error, plutôt qu'un tuple d'exception provenant de sys.exc_info().

  • Ceci s'ajoute au comportement existant et ne le remplace pas. L'utilisation précédente de notice_error() sans arguments ou avec un tuple d'exception devrait toujours fonctionner correctement.

• Ajouter la prise en charge de gpt-5 et des modèles LLM OpenAI plus récents

  • Ajouter des mises à jour à l'instrumentation OpenAI pour prendre en charge les noms d'attributs plus récents utilisés avec les modèles OpenAI ultérieurs

• Ajouter la prise en charge de la capture d'erreurs d'outils synchrones Strands-Agent

  • Les fonctions Python synchrones utilisées comme outils dans Strands-Agents ont désormais une capture d'erreur appropriée et capturent les traces dans des outils tels que les recherches dans la base de données.

Débogage

• Se prémunir contre les plantages lors de l'utilisation d'Azure Functions

  • Auparavant, certains utilisateurs rencontraient des cas limites où la détection d'utilisation d'Azure Functions plantait lors de la tentative de correspondance des expressions régulières. Le plantage a été corrigé et ne devrait plus être possible à l'avenir.

Déclaration de soutien

Nous vous recommandons de mettre à jour vers la dernière version de l'agent dès qu'elle est disponible. Si vous ne pouvez pas effectuer la mise à niveau vers la dernière version, mettez à jour vos agents vers une version datant de moins de 90 jours. En savoir plus sur la façon de tenir les agents informés.

Consultez la politique EOL de l'agent Python de New Relic pour obtenir des informations sur la sortie de l'agent et les dates de support.

Remarques

Cette sortie de l'agent Python ajoute la prise en charge des éléments suivants :

• Brins
• AWS Bedrock Converse Streaming
• Méthodes Redis hybrid_search et msetex
• Attributions de rôles LangChain pour l'événement LLM
• LLM événement horodatage capturé au moment de la demande LLM
• loop_factory paramètre dans asyncio.Runner

Cette mise à jour corrige également un bug dans l'instrumentation ASGI où les en-têtes ne sont pas signalés par le serveur web.

Installez l'agent en utilisant easy_install/pip/distribute via l' index des packagesPython , en utilisant conda via l' index des packages Conda-Forge, ou téléchargez-le directement depuis le site de téléchargement de New Relic.

Caractéristiques

• Ajout de la prise en charge de Strands

  • Ajouter des instruments pour les outils et agents Strands dans des configurations mono-agent et multi-agents (essaims, graphes, etc.).

• Ajout de la prise en charge du streaming Converse sur AWS Bedrock

  • Ajout de la prise en charge monitoring pour l'API Converse en streaming. Cela inclut la prise en charge des appels de complétion de chat Converse effectués avec les clients boto3 et aioboto3 utilisant converse_stream().

• Ajout de la prise en charge des méthodes Redis

  • Ajouter la prise en charge des méthodes suivantes :

    • hybrid_search
    • msetex

• Ajouter la prise en charge de loop_factory dans asyncio.Runner

  • Dans Python 3.11, la classe asyncio.Runner a été ajoutée ainsi que le paramètre loop_factory. Le paramètre loop_factory fournit un remplacement pour les politiques de boucle. La boucle ainsi créée est désormais instrumentée, que ce soit via un paramètre de boucle d'événements global ou une boucle d'événements personnalisée.

• Capturer les attributions de rôles LangChain dans un événement LLM

  • L'événement LangChain LlmChatCompletionMessage contient désormais le rôle attribué par LangChain.

• Capture de l'horodatage de l'événement LLM au moment de la requête LLM

  • Auparavant, la date et l'heure de l'événement LLM étaient enregistrées au moment de sa création. Désormais, cette information est saisie avec plus de précision au moment de la demande de LLM.

Débogage

• consommation d'en-tête ASGI

  • Lorsqu'un ASGIWebTransaction consomme les en-têtes d'un événement http.response.start, il le fait sans tenir compte des types d'entrée autorisés. Lorsque les en-têtes sont un générateur, le générateur a été consommé par l'appel à process_response() ne laissant aucun en-tête à envoyer au serveur Web. Ce problème est maintenant résolu.

Déclaration de soutien

Nous vous recommandons de mettre à jour vers la dernière version de l'agent dès qu'elle est disponible. Si vous ne pouvez pas effectuer la mise à niveau vers la dernière version, mettez à jour vos agents vers une version datant de moins de 90 jours. En savoir plus sur la façon de tenir les agents informés.

Consultez la politique EOL de l'agent Python de New Relic pour obtenir des informations sur la sortie de l'agent et les dates de support.