Python agent release notesRSS

Notes

This release of the Python agent adds support for time to first token and fixes an incompatible Flask add_url_rule function signature.

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.

New features

• Added time to first token for LLM response streams:

  • The agent records a new attribute,time_to_first_token on LlmChatCompletionSummary events for OpenAI and Bedrock response streams. This attribute measures the duration between the initial request and the first token received in the response.

Bugs fixes

• Resolved Flask add_url_rule function signature mismatch

  • Updated the instrumentation for Flask's to align its add_url_rule function signature with the native Flask implementation. This fix prevents potential application crashes caused by the previous signature mismatch.

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 elimina el soporte para Cross Application Tracing (CAT), Python 3.8 y los certificados SSL incluidos. También actualiza todos los paquetes vendored a sus últimas versiones y agrega soporte para CPython free-threaded, sistemas operativos Windows e instrumentación mejorada para Microsoft AG2 (Autogen). Además, esta versión incluye un nuevo extra opcional para instalar certificados SSL a través de certifi. Esta versión también corrige un error en la instrumentación de Strands Agents que causaba que se reportaran excepciones duplicadas.

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 eliminada

• El rastreo entre aplicaciones (CAT) se ha eliminado en favor del rastreo distribuido (DT).

  • Cross Application Tracing (CAT) quedó obsoleto en la versión del agente 7.0.0.166 y se eliminó en esta versión. Si aún utiliza Cross Application Tracing (CAT), le recomendamos migrar a Distributed Tracing (DT) lo antes posible para evitar interrupciones.

• Los certificados SSL incluidos han sido eliminados.

  • Si requiere certificados para su entorno, puede instalarlos mediante el administrador de paquetes de su sistema operativo o instalar el agente con el extra opcional newrelic[certificates].

• Se ha eliminado el soporte para Python 3.8.

  • Python 3.8 llegó al final de su vida útil el 2024-10-07 y ya no es compatible con el agente. Considere actualizar su aplicación a una versión compatible de Python para continuar recibiendo actualizaciones del Agente de Python.

Seguridad

• Todos los paquetes internos se actualizaron a sus últimas versiones.

  • urllib3 actualizado a la v2.6.3
    • Esto corrige todos los CVE abiertos en urllib3 a la fecha de este lanzamiento.
  • opentelemetry_proto actualizado a v1.40.0
  • wrapt actualizado a v2.1.2
  • asgiref actualizado a v3.11.1

Nueva característica

• Nuevo extra newrelic[certificates] para instalar certificados SSL mediante certifi.

  • El agente ahora proporciona un extra newrelic[certificates] opcional que se puede utilizar para instalar los certificados SSL incluidos. Esto está destinado a usuarios que requieren certificados pero no pueden instalarlos a través del administrador de paquetes de su sistema operativo.

• Soporte para CPython de hilos libres

  • A partir de Python 3.13, CPython lanza compilaciones de Python con el Bloqueo Global del Intérprete (GIL) deshabilitado, lo que permite un verdadero multihilo.
  • Esta versión agrega soporte para este comportamiento, permitiendo que el agente se ejecute de forma segura en un entorno de subprocesos libres.
  • Esta versión también incluye binarios precompilados para CPython de subprocesos libres en Linux y Windows, lo que permite una fácil instalación en estos entornos.

• Soporte de Windows

  • Esta versión incluye binarios precompilados para CPython 3.13 o superior en Windows.
  • Tenga en cuenta que Python 3.12 o inferior no es compatible oficialmente en Windows debido a grandes variaciones en la resolución de los temporizadores. Todavía es posible instalar y usar el agente desde el código fuente, pero los usuarios pueden experimentar problemas con datos de temporización inexactos y deben actualizar a Python 3.13 o superior para obtener la mejor experiencia.

• Instrumentación mejorada para Microsoft AG2 (Autogen)

  • Se agregó soporte para la transmisión de respuestas mediante el método generador asincrónico on_messages_stream().
  • La instrumentación 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.

Errores

• Excepciones duplicadas en Strands Agents

  • Después de una actualización de Strands Agents que encapsula algunas excepciones en un nuevo tipo EventLoopException, se podrían reportar errores duplicados. Esto se ha corregido y el error subyacente solo debe reportarse una vez.

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