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 ainvoke(),ainvoke(),stream()yastream().
- Agrega instrumentación para las invocaciones de agentes de LangGraph a través de
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 argumentoerror, en lugar de una tupla de excepción desys.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-5y 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_searchymsetex - Asignaciones de roles de LangChain para eventos LLM
- timestamp del evento LLM capturada en el momento de la solicitud LLM
loop_factoryparámetro enasyncio.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().
- 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
Agregar soporte para métodos Redis
Agregue soporte para los siguientes métodos:
hybrid_searchmsetex
Agregar soporte para
loop_factoryenasyncio.Runner- En Python 3.11, se agregó la clase
asyncio.Runnery también el parámetroloop_factory. El parámetroloop_factoryproporciona 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.
- En Python 3.11, se agregó la clase
Capturar asignaciones de roles de LangChain en eventos LLM
- El evento LangChain
LlmChatCompletionMessageahora contiene el rol asignado de LangChain.
- El evento 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
ASGIWebTransactionconsume los encabezados de un eventohttp.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 aprocess_response()y no dejó ningún encabezado restante para que el servidor sitio web envíe. Esto ya fue solucionado.
- Cuando un
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.enabledNEW_RELIC_ATTRIBUTES_ENABLEDattributes.excludeNEW_RELIC_ATTRIBUTES_EXCLUDEattributes.includeNEW_RELIC_ATTRIBUTES_INCLUDEbrowser_monitoring.attributes.enabledNEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_ENABLEDbrowser_monitoring.attributes.excludeNEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_EXCLUDEbrowser_monitoring.attributes.includeNEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_INCLUDEerror_collector.attributes.enabledNEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_ENABLEDerror_collector.attributes.excludeNEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_EXCLUDEerror_collector.attributes.includeNEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_INCLUDEspan_events.attributes.enabledNEW_RELIC_SPAN_EVENTS_ATTRIBUTES_ENABLEDspan_events.attributes.excludeNEW_RELIC_SPAN_EVENTS_ATTRIBUTES_EXCLUDEspan_events.attributes.includeNEW_RELIC_SPAN_EVENTS_ATTRIBUTES_INCLUDEtransaction_events.attributes.enabledNEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_ENABLEDtransaction_events.attributes.excludeNEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_EXCLUDEtransaction_events.attributes.includeNEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_INCLUDEtransaction_segments.attributes.enabledNEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_ENABLEDtransaction_segments.attributes.excludeNEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_EXCLUDEtransaction_segments.attributes.includeNEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_INCLUDEtransaction_tracer.attributes.enabledNEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_ENABLEDtransaction_tracer.attributes.excludeNEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_EXCLUDEtransaction_tracer.attributes.includeNEW_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_settingsupdate_account_settingsupdate_max_record_sizeupdate_stream_warm_throughput
Corrección de errores
Evitar un error de recursión en el grupo de conexiones de aiomysql
- Anteriormente, se generaba un
RecursionErroren aiomysql al usar conexiones agrupadas. Se crearon cadenas profundasObjectProxyalrededor de las conexiones agrupadas debido al envolvimiento repetido. Esto ya está solucionado.
- Anteriormente, se generaba un
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.
- Se corrigió un error por el cual la instrumentación para
Corregir error al llamar a
shutdown_agentdesde dentro del hilo de cosecha- Anteriormente, podía ocurrir un
RuntimeErrorcuando se llamabashutdown_agentdesde dentro del hilo de cosecha. Esto soluciona ese problema agregando una protección para evitar el fallo.
- Anteriormente, podía ocurrir un
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.
- Eliminar llamadas a
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.
- Esto corrige un error creado cuando las configuraciones
Proteger contra accidentes por
trace_cache.pop()- En la clase
ContextOf, hubo un acceso inseguro detrace_cachea través depop(key)sin un valor predeterminado. Esto provocó fallos cuando elweakrefen el diccionario ya fue recolectado como basura.
- En la clase
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.
Notes
Caution
This version of the agent has been yanked.
This release of the Python agent makes the following changes:
- Removes support for Python 3.7
- Removes and or deprecates various APIs and settings
- Deprecates aioredis instrumentation
- Raises the minimum supported version of
setuptoolsandsetuptools_scm - Adds new instrumentation for AutoGen
- Adds new instrumentation for Pyzeebe
- Adds new MCP (Model Context Protocol) named spans
- Fixes a crash in psycopg
- Ensures MCP spans are only recorded when AI monitoring is enabled
Install the agent using easy_install/pip/distribute via the Python Package Index or download it directly from the New Relic download site.
Removed features
Removes support for Python 3.7
- Python 3.7 was EOL'd June 27, 2023. The Python agent has dropped support for it.
Removes various deprecated APIs
The following APIs have been removed:
Legacy API Replacement API accept_distributed_trace_payloadaccept_distributed_trace_headersadd_custom_parameteradd_custom_attributeadd_custom_parametersadd_custom_attributescreate_distributed_trace_payloadinsert_distributed_trace_headersget_browser_timing_footerThe functionality of this has been wrapped into get_browser_timing_header()record_exceptionnotice_error()NewRelicLogHandlerNewRelicLogForwardingHandlerlambda_handler&LambdaHandlerWrapperThese APIs have moved to the newrelic-lambdapackage.
Removes various deprecated settings
The following settings have been removed:
Legacy Setting Replacement Setting transaction_tracer.capture_attributestransaction_tracer.attributes.enablederror_collector.capture_attributeserror_collector.attributes.enabledbrowser_monitoring.capture_attributesbrowser_monitoring.attributes.enabledanalytics_events.enabledtransaction_events.enabledanalytics_events.capture_attributestransaction_events.attributes.enablederror_collector.ignore_errorserror_collector.ignore_classesstrip_exception_messages.whiteliststrip_exception_messages.allowlistsslThis is now hardcoded to trueso it has been removed as a setting option.ignored_paramsUse newrelic.attributes.exclude = request.parameters.{name}instead. Add each request parameter key to thenewrelic.attributes.excludelist, delimited by commas. Be sure to prepend the key withrequest.parameters.agent_limits.merge_stats_maximumThis is now completely ignored in favor of serverside config.
Deprecated features
Instrumentation for aioredis has been deprecated
Deprecates some existing harvest settings to match other language agents
In order to be more consistent with the conventions of the other language agents, the following harvest settings are now deprecated:
Legacy Setting Replacement Setting event_harvest_config.harvest_limits.analytic_event_datatransaction_events.max_samples_storedevent_harvest_config.harvest_limits.span_event_dataspan_events.max_samples_storedevent_harvest_config.harvest_limits.error_event_dataerror_collector.max_event_samples_storedevent_harvest_config.harvest_limits.custom_event_datacustom_insights_events.max_samples_storedevent_harvest_config.harvest_limits.log_event_dataapplication_logging.forwarding.max_samples_storedThis is a revert of a previous change that renamed these settings from
*.max_samples_storedto theevent_harvest_config.harvest_limits.*form. This decision has been reversed, and the original settings named have been restored to match the other language agents who did not change these settings names. The deprecated settings will continue to work for now, but they will be removed in a future release.
Deprecates configuration of the agent through the WSGI environ dictionary
The following settings which were previously possible to configure through the WSGI environ dictionary are now deprecated. Please configure these settings through environment variables or the config file.
newrelic.set_background_tasknewrelic.suppress_apdex_metricnewrelic.suppress_transaction_tracenewrelic.capture_request_paramsnewrelic.disable_browser_autorum
Deprecates support for building the agent with
setuptools<61.2orsetuptools_scm<6.4- The minimum supported versions of
setuptoolsandsetuptools_scmhave been increased to61.2and6.4respectively. This is to support the use ofpyproject.tomlfor configuring the package metadata and building instructions. The agent can now be built with more modern build tools which will no longer log warnings about the lack of apyproject.tomlfile. - This change adds new version attributes to the packages,
newrelic.__version__andnewrelic.__version_tuple__, which can be used to programmatically check the version of the agent at runtime.
- The minimum supported versions of
New features
Adds new instrumentation for AutoGen
- Adds instrumentation (named spans and custom
Llmevents) for agents and tools in AutoGen
- Adds instrumentation (named spans and custom
Adds new instrumentation for Pyzeebe
- Adds automatic instrumentation and framework-specific agent attributes for Pyzeebe
Adds new MCP (Model Context Protocol) named spans
- Adds new named spans for MCP (Model Context Protocol) tool calls made via tool manager to support Streamable HTTP
Bug fixes
Fixes a crash in
psycopg>=3.2.0when callingas_string()- Fixes an issue in
psycopg>=3.2.0where theas_string()method no longer required arguments, causing a potential crash. This has been fixed, and both signatures of this method are supported.
- Fixes an issue in
Ensures MCP (Model Context Protocol) spans are only recorded when AI monitoring is enabled
- Ensures MCP (Model Context Protocol) spans are only recorded when the setting
ai_monitoring.enabledis enabled.
- Ensures MCP (Model Context Protocol) spans are only recorded when the setting
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.