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.

Notas

Esta versión del agente de Python agrega soporte para trazas/spans para el Agente híbrido, la integración de New Relic con OpenTelemetry. También agrega GUID de entidad a los archivos de verificación de estado de Agent Control, atributos subcomponent a la instrumentación de IA agéntica, soporte para nuevos métodos de cliente Redis, corrige un error donde puede haber instancias duplicadas de ImportHookFinder y un error en la instrumentación Cursor.callproc() de OracleDB.

Instale el agente usando easy_install/pip/distribute a través del Índice de paquetes de Python, usando conda a través del Índice de paquetes de Conda-Forge, o descárguelo directamente desde el sitio de descargas de New Relic.

Característica

• Agregar soporte de rastreo para el Agente Híbrido

  • Hybrid Agent está diseñado para cerrar la brecha para los equipos que buscan adoptar los estándares de OpenTelemetry, manteniendo la compatibilidad con versiones anteriores de sus dashboards de New Relic existentes. Hybrid Agent ofrece una experiencia de "lo mejor de ambos mundos" al combinar la visibilidad profunda de New Relic con la compatibilidad con la API de OpenTelemetry. Proporciona una solución de observabilidad con soporte integrado para las siguientes API de OpenTelemetry:

    • Rastreo
    • Instrumentación de biblioteca independiente y framework nativo

  • Mejoras clave como Span Links y Events on Spans ya están disponibles, asegurando una interoperabilidad sin fisuras en entornos de modo mixto.

• Introduce un nuevo muestreador basado en la proporción de Trace ID

  • Un nuevo muestreador basado en la proporción de Trace ID. Este algoritmo de muestreo se basa en el muestreador del mismo nombre de OpenTelemetry y se puede configurar para muestrear un porcentaje establecido de transacciones.

• Agregar subcomponent atributos a la instrumentación de IA agéntica

  • La instrumentación para LangChain, MCP y Strands ahora incluye un atributo subcomponent en los spans que representan llamadas de herramientas o agentes. Esto se utiliza para proporcionar un mapeo de entidades mejorado en la UI de New Relic.

• Agregar el GUID de la entidad a los archivos de verificación de estado de Agent Control

  • Cuando se inicia el agente dentro de un entorno de Agent Control, se crea un archivo de comprobación de estado en la ubicación de archivo configurada para cada proceso del agente. Este archivo ahora incluye el GUID de la entidad relacionada con el agente cuando esté disponible.

• Agregar instrumentación para nuevos métodos de Redis

  • Agregue instrumentación para los siguientes nuevos métodos en los clientes de Redis:

    • hotkeys_get
    • Restablecer atajos
    • inicio_atajos
    • hotkeys_stop
    • vrange
    • xcfgset

Errores

• Corregir instancias duplicadas de ImportHookFinder

  • Anteriormente, era posible que se agregaran duplicados del buscador de ganchos de importación a sys.meta_path.

• Corregir la firma incorrecta en OracleDB Cursor.callproc()

  • Anteriormente, intentar usar argumentos de palabra clave con Cursor.callproc() causaba fallos, ya que los nombres de los argumentos eran incorrectos en nuestra instrumentación. Esto se ha corregido, y el argumento adicional keyword_parameters ahora también es compatible.

Declaración de apoyo

Recomendamos actualizar a la última versión del agente tan pronto como esté disponible. Si no puede actualizar a la última versión, actualice su agente a una versión que no tenga más de 90 días de antigüedad. Obtenga más información sobre cómo mantener al agente actualizado.

Consulte la New Relic Python política de fin de vida del agente para obtener información sobre los lanzamientos del agente y las fechas de soporte.

Notas

Esta versión del agente de Python agrega soporte para agentes de LangGraph.

Instale el agente usando easy_install/pip/distribute a través del Índice de paquetes de Python, usando conda a través del Índice de paquetes de Conda-Forge, o descárguelo directamente desde el sitio de descargas de New Relic.

Característica

• Agregar soporte para agentes de LangGraph

  • Agrega instrumentación para las invocaciones de agentes de LangGraph a través de create_agent() en LangChain. Esto incluye llamadas del agente a invoke(), ainvoke(), stream() y astream().

Declaración de apoyo

Recomendamos actualizar a la última versión del agente tan pronto como esté disponible. Si no puede actualizar a la última versión, actualice su agente a una versión que no tenga más de 90 días de antigüedad. Obtenga más información sobre cómo mantener al agente actualizado.

Consulte la New Relic Python política de fin de vida del agente para obtener información sobre los lanzamientos del agente y las fechas de soporte.

Notas

Esta versión del agente de Python agrega nuevas formas de pasar errores a notice_error(), agrega soporte para la captura de errores de herramientas síncronas de Strands-Agent, agrega soporte para los modelos gpt-5 y más recientes de OpenAI LLM, y corrige un fallo en la lógica de utilización de Azure Functions.

Instale el agente usando easy_install/pip/distribute a través del Índice de paquetes de Python, usando conda a través del Índice de paquetes de Conda-Forge, o descárguelo directamente desde el sitio de descargas de New Relic.

Característica

• Agregar soporte para instancias de excepción como argumentos para notice_error()

  • notice_error() ahora puede aceptar una instancia de excepción capturada (como una de un bloque try/except) para el argumento error, en lugar de una tupla de excepción de sys.exc_info().

  • Esto se suma al comportamiento existente y no lo reemplaza. El uso anterior de notice_error() con cero argumentos o con una tupla de excepción aún debería funcionar correctamente.

• Agregar soporte para los modelos gpt-5 y más recientes de OpenAI LLM

  • Agregue actualizaciones a la instrumentación de OpenAI para admitir nombres de atributos más nuevos utilizados con modelos OpenAI más recientes

• Agregar soporte para la captura de errores de la herramienta síncrona Strands-Agent

  • Las funciones síncronas de Python utilizadas como herramientas en Strands-Agents ahora tienen una captura de errores adecuada y capturan rastreos dentro de herramientas como búsquedas en bases de datos.

Corrección de errores

• Proteger contra fallas en la utilización de Azure Functions

  • Anteriormente, algunos usuarios experimentaron casos extremos en los que la detección de utilización de Azure Functions fallaba al intentar hacer coincidir expresiones regulares. El fallo se ha solucionado y ya no debería ser posible en el futuro.

Declaración de apoyo

Recomendamos actualizar a la última versión del agente tan pronto como esté disponible. Si no puede actualizar a la última versión, actualice su agente a una versión que no tenga más de 90 días de antigüedad. Obtenga más información sobre cómo mantener al agente actualizado.

Consulte la New Relic Python política de fin de vida del agente para obtener información sobre los lanzamientos del agente y las fechas de soporte.

Notas

Esta versión del agente Python agrega soporte para lo siguiente:

• Hebras
• Transmisión de AWS Bedrock Converse
• Métodos Redis hybrid_search y msetex
• Asignaciones de roles de LangChain para eventos LLM
• timestamp del evento LLM capturada en el momento de la solicitud LLM
• loop_factory parámetro en asyncio.Runner

Esta versión también soluciona un error en la instrumentación ASGI donde el servidor sitio web no informa los encabezados.

Instale el agente usando easy_install/pip/distribute a través del Índice de paquetes de Python, usando conda a través del Índice de paquetes de Conda-Forge, o descárguelo directamente desde el sitio de descargas de New Relic.

Característica

• Agregar soporte para Strands

  • Agregar instrumentación para herramientas y agentes de Strands en configuraciones de uno o varios agentes (enjambres, gráficos, etc.)

• Agregar soporte para AWS Bedrock Converse Streaming

  • Agregue soporte de monitoreo para la transmisión de API de Converse. Esto incluye soporte para llamadas de finalización de chat de Converse realizadas con clientes boto3 y aioboto3 usando converse_stream().

• Agregar soporte para métodos Redis

  • Agregue soporte para los siguientes métodos:

    • hybrid_search
    • msetex

• Agregar soporte para loop_factory en asyncio.Runner

  • En Python 3.11, se agregó la clase asyncio.Runner y también el parámetro loop_factory. El parámetro loop_factory proporciona un reemplazo para las políticas de bucle. Ahora, el bucle que se crea se instrumenta, independientemente de si es a través de una configuración de bucle de eventos global o un bucle de eventos personalizado.

• Capturar asignaciones de roles de LangChain en eventos LLM

  • El evento LangChain LlmChatCompletionMessage ahora contiene el rol asignado de LangChain.

• Capturar timestamp del evento LLM en el momento de la solicitud LLM

  • Anteriormente, la timestamp del evento LLM se capturaba en el momento de la creación del evento. Ahora, se captura con mayor precisión el momento de la solicitud de LLM.

Corrección de errores

• Consumo de encabezado ASGI

  • Cuando un ASGIWebTransaction consume los encabezados de un evento http.response.start, lo hace sin tener en cuenta los tipos de entrada permitidos. Cuando los encabezados son un generador, el generador fue consumido por la llamada a process_response() y no dejó ningún encabezado restante para que el servidor sitio web envíe. Esto ya fue solucionado.

Declaración de apoyo

Recomendamos actualizar a la última versión del agente tan pronto como esté disponible. Si no puede actualizar a la última versión, actualice su agente a una versión que no tenga más de 90 días de antigüedad. Obtenga más información sobre cómo mantener al agente actualizado.

Consulte la New Relic Python política de fin de vida del agente para obtener información sobre los lanzamientos del agente y las fechas de soporte.