Python agent release notesRSS

Notes

This release of the Python agent adds new ways of passing errors to notice_error(), adds support for Strands-Agent synchronous tool error capturing, adds support for gpt-5 and newer OpenAI LLM models, and fixes a crash in Azure Functions' utilization logic.

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.

Features

• Add support for exception instances as arguments to notice_error()

  • notice_error() can now accept a caught exception instance (such as one from a try/except block) for the error argument, rather than an exception tuple from sys.exc_info().

  • This is in addition to and does not replace the existing behavior. Previous usage of notice_error() with zero arguments or with an exception tuple should still function correctly.

• Add support for gpt-5 and newer OpenAI LLM models

  • Add updates to OpenAI instrumentation to support newer attribute names used with later OpenAI models

• Add support for Strands-Agent synchronous tool error capturing

  • Synchronous Python functions used as tools in Strands-Agents now have proper error capturing, and capture traces within tools such as database lookups.

Bug fixes

• Guard against crashes in Azure Functions utilization

  • Previously, some users experienced edge cases where Azure Functions utilization detection would crash when attempting to match regular expressions. The crash has been fixed, and should no longer be possible in the future.

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

Notas

Esta versión del agente Python agrega soporte Python 3.14, nuevas variables de entorno para la configuración de filtros de atributos, soporte para generadores asíncronos en decoradores de transacciones, modelos adicionales en AWS Bedrock y nuevos métodos en AWS Kinesis. Esta versión también corrige un error en aiomysql que causaba RecursionError al usar ConnectionPool cuando estaba envuelto varias veces, un error donde las propiedades no se pasaban correctamente en el productor de kombu y un error cuando se llama a shutdown_agent desde dentro del hilo de cosecha.

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 Python 3.14

  • Agregar soporte para Python 3.14.

• Agregar variables de entorno para la configuración de filtros de atributos

  • Ahora es posible configurar los siguientes ajustes mediante variables de entorno:

    configuración Configuración	Variable ambiental
    attributes.enabled	NEW_RELIC_ATTRIBUTES_ENABLED
    attributes.exclude	NEW_RELIC_ATTRIBUTES_EXCLUDE
    attributes.include	NEW_RELIC_ATTRIBUTES_INCLUDE
    browser_monitoring.attributes.enabled	NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_ENABLED
    browser_monitoring.attributes.exclude	NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_EXCLUDE
    browser_monitoring.attributes.include	NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_INCLUDE
    error_collector.attributes.enabled	NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_ENABLED
    error_collector.attributes.exclude	NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_EXCLUDE
    error_collector.attributes.include	NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_INCLUDE
    span_events.attributes.enabled	NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_ENABLED
    span_events.attributes.exclude	NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_EXCLUDE
    span_events.attributes.include	NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_INCLUDE
    transaction_events.attributes.enabled	NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_ENABLED
    transaction_events.attributes.exclude	NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_EXCLUDE
    transaction_events.attributes.include	NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_INCLUDE
    transaction_segments.attributes.enabled	NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_ENABLED
    transaction_segments.attributes.exclude	NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_EXCLUDE
    transaction_segments.attributes.include	NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_INCLUDE
    transaction_tracer.attributes.enabled	NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_ENABLED
    transaction_tracer.attributes.exclude	NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_EXCLUDE
    transaction_tracer.attributes.include	NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_INCLUDE

• Agregar soporte para generadores asíncronos en los decoradores de errores

  • Anteriormente, los decoradores de transacción no admitían ser envueltos alrededor de generadores asíncronos. Se agregó esta funcionalidad y las transacciones de generadores asíncronos ahora medirán automáticamente el tiempo de espera del bucle de eventos y otras estadísticas.

• Agregar compatibilidad con modelos adicionales en la instrumentación de AWS Bedrock

  • Actualiza la instrumentación de AWS Bedrock mediante botocore y aiobotocore para admitir los siguientes modelos adicionales.

    • Modelos Claude Sonnet 3+
    • Modelos que tienen como prefijo una región (con reconocimiento de región)

• Agregar instrumentación para los nuevos métodos de Kinesis

  • Agrega instrumentación de botocore para admitir nuevos métodos de AWS Kinesis

    • describe_account_settings
    • update_account_settings
    • update_max_record_size
    • update_stream_warm_throughput

Corrección de errores

• Evitar un error de recursión en el grupo de conexiones de aiomysql

  • Anteriormente, se generaba un RecursionError en aiomysql al usar conexiones agrupadas. Se crearon cadenas profundas ObjectProxy alrededor de las conexiones agrupadas debido al envolvimiento repetido. Esto ya está solucionado.

• Se corrigió un error por el cual las propiedades no se pasaban correctamente al productor de kombu.

  • Se corrigió un error por el cual la instrumentación para kombu.messaging.Producer.publish() provocaba que las propiedades se anidaran accidentalmente dentro del diccionario, lo que hacía que las propiedades estuvieran en el lugar incorrecto y no fueran leídas por los paquetes posteriores.

• Corregir error al llamar a shutdown_agent desde dentro del hilo de cosecha

  • Anteriormente, podía ocurrir un RuntimeError cuando se llamaba shutdown_agent desde dentro del hilo de cosecha. Esto soluciona ese problema agregando una protección para evitar el fallo.

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 proporciona correcciones para la activación temprana en la instrumentación de Django, anulaciones del lado del servidor para max_samples_stored que se ignoran y protección contra fallas de trace_cache.pop().

Instale el agente usando easy_install/pip/distribute a través del Índice de paquetes de Python o descárguelo directamente del sitio de descarga de New Relic.

Corrección de errores

• Previene la activación temprana en la instrumentación de Django

  • Eliminar llamadas a application_settings() en la instrumentación Django para evitar problemas con activaciones tempranas en aplicaciones pre-fork.

• Solucionar problemas de sincronización de la configuración del servidor con la configuración local

  • Esto corrige un error creado cuando las configuraciones event_harvest_config.harvest_limits.* quedaron obsoletas en favor de las configuraciones *.max_samples_stored. Algunas configuraciones del lado del servidor no anulaban la configuración del lado del cliente, lo que provocaba que los datos se enviaran al recopilador a pesar de que el usuario lo deshabilitara.

• Proteger contra accidentes por trace_cache.pop()

  • En la clase ContextOf, hubo un acceso inseguro de trace_cache a través de pop(key) sin un valor predeterminado. Esto provocó fallos cuando el weakref en el diccionario ya fue recolectado como basura.

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 realiza los siguientes cambios:

• Elimina la compatibilidad con Python 3.7
• Elimina o desaprueba varias API y configuraciones
• Se desestima la instrumentación aioredis
• Aumenta la versión mínima compatible de setuptools y setuptools_scm
• Agrega nueva instrumentación para AutoGen
• Agrega nueva instrumentación para Pyzeebe
• Agrega nuevos intervalos con nombre MCP (Protocolo de contexto de modelo)
• Corrige un fallo en psycopg
• Garantiza que los intervalos de MCP solo se registren cuando el monitoreo de IA está habilitado

Instale el agente usando easy_install/pip/distribute a través del Índice de paquetes de Python o descárguelo directamente del sitio de descarga de New Relic.

Característica eliminada

• Elimina la compatibilidad con Python 3.7

  • Python 3.7 finalizó su vida útil el 27 de junio de 2023. El agente de Python dejó de brindar soporte para este.

• Elimina varias API obsoletas

  • Se eliminaron las siguientes API:

    APIheredada	API de reemplazo
    accept_distributed_trace_payload	accept_distributed_trace_headers
    add_custom_parameter	add_custom_attribute
    add_custom_parameters	add_custom_attributes
    create_distributed_trace_payload	insert_distributed_trace_headers
    get_browser_timing_footer	La funcionalidad de esto se incluyó en get_browser_timing_header()
    record_exception	notice_error()
    NewRelicLogHandler	NewRelicLogForwardingHandler
    lambda_handler & LambdaHandlerWrapper	Estas API se trasladaron al paquete newrelic-lambda.

• Elimina varias configuraciones obsoletas

  • Se eliminaron las siguientes configuraciones:

    Configuración heredada	Ajuste de reemplazo
    transaction_tracer.capture_attributes	transaction_tracer.attributes.enabled
    error_collector.capture_attributes	error_collector.attributes.enabled
    browser_monitoring.capture_attributes	browser_monitoring.attributes.enabled
    analytics_events.enabled	transaction_events.enabled
    analytics_events.capture_attributes	transaction_events.attributes.enabled
    error_collector.ignore_errors	error_collector.ignore_classes
    strip_exception_messages.whitelist	strip_exception_messages.allowlist
    ssl	Esto ahora está codificado en true, por lo que se eliminó como opción de configuración.
    ignored_params	Emplee newrelic.attributes.exclude = request.parameters.{name} en su lugar. Agregue cada clave de parámetro de solicitud a la lista newrelic.attributes.exclude, delimitada por comas. Cerciorar de anteponer request.parameters a la clave.
    agent_limits.merge_stats_maximum	Esto ahora se ignora por completo en favor de la configuración del lado del servidor.

Característica obsoleta

• La instrumentación para aioredis quedó obsoleta

  • El paquete aioredis quedó obsoleto en favor de redis, que ahora incluye el submódulo redis.asyncio. Como resultado, la instrumentación para aioredis también quedó obsoleta. Emplee la biblioteca redis en su lugar. Esta instrumentación se eliminará en una versión futura.

• Desestima algunas configuraciones de recolección existentes para que coincidan con otros agentes de idiomas

  • Para ser más coherentes con las convenciones del otro agente de idioma, las siguientes configuraciones de recolección ahora están obsoletas:

    Configuración heredada	Ajuste de reemplazo
    event_harvest_config.harvest_limits.analytic_event_data	transaction_events.max_samples_stored
    event_harvest_config.harvest_limits.span_event_data	span_events.max_samples_stored
    event_harvest_config.harvest_limits.error_event_data	error_collector.max_event_samples_stored
    event_harvest_config.harvest_limits.custom_event_data	custom_insights_events.max_samples_stored
    event_harvest_config.harvest_limits.log_event_data	application_logging.forwarding.max_samples_stored

    Esto es una reversión de un cambio anterior que renombró estas configuraciones del formato *.max_samples_stored al formato event_harvest_config.harvest_limits.*. Se revirtió esta decisión y se restauraron las configuraciones originales nombradas para que coincidan con el otro agente de idioma que no cambió los nombres de estas configuraciones. Las configuraciones obsoletas seguirán funcionando por ahora, pero se eliminarán en una versión futura.

• Desaprobó la configuración del agente a través del diccionario de entorno WSGI

  • Las siguientes configuraciones que antes se podían configurar a través del diccionario de entorno WSGI ahora están obsoletas. Configure estos ajustes a través de las variables de entorno o el archivo de configuración.

    • newrelic.set_background_task
    • newrelic.suppress_apdex_metric
    • newrelic.suppress_transaction_trace
    • newrelic.capture_request_params
    • newrelic.disable_browser_autorum

• Se desaprueba la compatibilidad con la creación del agente con setuptools<61.2 o setuptools_scm<6.4

  • Las versiones mínimas admitidas de setuptools y setuptools_scm se aumentaron a 61.2 y 6.4 respectivamente. Esto es para respaldar el uso de pyproject.toml para configurar los metadatos del paquete y las instrucciones de construcción. El agente ahora se puede construir con herramientas de construcción más modernas que ya no registrarán advertencias sobre la falta de un archivo pyproject.toml.
  • Este cambio agrega un nuevo atributo de versión a los paquetes, newrelic.__version__ y newrelic.__version_tuple__, que se pueden usar para verificar programáticamente la versión del agente en tiempo de ejecución.

Nueva característica

• Agrega nueva instrumentación para AutoGen

  • Agrega instrumentación (spans con nombre y eventos Llm personalizados) para agentes y herramientas en AutoGen

• Agrega nueva instrumentación para Pyzeebe

  • Agrega instrumentación automática y atributo de agente específico frameworkpara Pyzeebe.

• Agrega nuevos intervalos con nombre MCP (Protocolo de contexto de modelo)

  • Agrega nuevos intervalos con nombre para las llamadas a la herramienta MCP (Protocolo de contexto de modelo) realizadas a través del administrador de herramientas para admitir HTTP transmitible

Corrección de errores

• Corrige un fallo en psycopg>=3.2.0 al llamar as_string()

  • Corrige un problema en psycopg>=3.2.0 donde el método as_string() ya no requería argumentos, lo que causaba un posible bloqueo. Esto se solucionó y ahora se admiten ambas firmas de este método.

• Garantiza que los intervalos de MCP (Protocolo de contexto de modelo) solo se registren cuando el monitoreo de IA está habilitado

  • Garantiza que los intervalos MCP (Protocolo de contexto de modelo) solo se registren cuando la configuración ai_monitoring.enabled está habilitada.

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.