Python agent release notesRSS

Notes

This release of the Python agent adds instrumentation support for Google ADK, adds token counting for multiple AI providers (Anthropic, Google GenAI, OpenAI, and AWS Bedrock), reduces outbound tracestate header size, and fixes a crash in graphql-core instrumentation.

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.

Improved Features

• Added instrumentation for Google ADK

  • The Python agent now instruments Google ADK (Agent Development Kit) AI agent workflows.
  • Instrumented components include:
    • LlmAgent linked to Gemini or VertexAI backends via google.genai
    • User-defined FunctionTool instances
    • Sub-agent workflows including child agents and AgentTool instances
    • Multi-agent workflows including the Workflow class and deprecated LoopAgent, ParallelAgent, and SequentialAgent classes

• Added token counting for Anthropic, Gemini, OpenAI, and Bedrock

  • The Python agent now reports token counts for all LLM invocations across multiple AI providers:
    • Anthropic SDK
    • Google GenAI SDK
    • OpenAI SDK
    • AWS Bedrock via botocore and aiobotocore

Bugs

• Fixed instrumentation crash for graphql-core v3.2.10

  • Previously, graphql-core v3.2.10 renamed the errors attribute to collected_errors in ExecutionContext, causing the agent to crash. This has been fixed, and the agent now works correctly with graphql-core v3.2.10 and later.

• Removed spanId from outbound tracestate header

  • Previously, the agent included spanId in the outbound tracestate header. Because spanId is already present in the traceparent header, this was unnecessary duplication. The spanId has been removed from tracestate to reduce outbound header size.

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 información adicional del modelo a los eventos de LLM de la cadena de LangChain y soluciona un error en la instrumentación de streaming 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ísticas mejoradas

• Agregar información adicional del modelo a los eventos de LLM de la cadena de LangChain

  • Agregue los atributos request.model y response.model a los eventos de LLM producidos por las cadenas de LangChain.
  • Esta información se recopila en la medida de lo posible y puede no estar siempre disponible.

Errores

• Corregir TypeError en la instrumentación de streaming de LangGraph

  • Anteriormente, al usar un subconjunto de API de streaming en LangGraph, el agente encontraba un TypeError debido al uso de weakref.WeakMethod por parte de LangGraph. Esto se ha corregido, y el agente ahora debería funcionar correctamente con esos métodos de streaming de LangGraph.

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 varios comandos nuevos de Redis, corrige un error en la instrumentación de LangGraph y mejora el manejo y el logging de la configuración de los límites de recolección.

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ísticas mejoradas

• Agregar instrumentación para nuevos comandos de Redis v8.8.0

  • Agregue instrumentación para los siguientes nuevos comandos de Redis de redis-py v8.8.0:

    • Comandos varios: INCREX, XNACK
    • Comandos de matriz: ARCOUNT, ARDEL, ARDELRANGE, ARGET, ARGETRANGE, ARGREP, ARINFO, ARINSERT, ARLASTITEMS, ARLEN, ARMGET, ARMSET, ARNEXT, AROP, ARRING, ARSCAN, ARSEEK, ARSET

Errores

• Corregir fallo en la instrumentación de LangGraph

  • Anteriormente, al usar la instrumentación de LangGraph, el agente fallaba debido a un problema con la propagación del contexto a los trabajos en AsyncBackgroundExecutor. Esto se ha corregido, y el agente ahora debería funcionar correctamente con LangGraph.

• Manejo y logging mejorados de la configuración del límite de recolección

  • El agente ahora reporta con mayor precisión la lista de métodos de recolección y límites a la pestaña Entorno en New Relic One.
  • El agente ahora tiene un logging de depuración más consistente al inicio para la configuración del límite de recolección.

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 soluciona un problema de propagación del contexto en LangChain y LangGraph, un problema de registro de finalización de chat de OpenAI y un problema al usar el streaming de OpenAI(https://pypi.org/project/openai) a través de LiteLLM como proxy.

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.

Errores

• Corregir la propagación del contexto en LangChain y LangGraph

  • Agrega propagación adicional del contexto de transacción a LangChain y LangGraph para admitir una gama más amplia de estructuras de aplicación.

• Solucionar un problema de registro de completado de chat de OpenAI

  • OpenAI reintrodujo la lógica que cierra la respuesta en streaming incluso si el consumidor no ha leído todos los datos. Anteriormente, los datos de finalización del chat solo se registraban al llegar al final del flujo, lo que provocaba que los datos de finalización del chat no se registraran al cierre del flujo. Ahora se ha agregado lógica para capturar los datos de finalización del chat incluso si el flujo no se ha leído por completo.

• Solucionar un problema al usar el streaming de OpenAI a través de LiteLLM como proxy

  • Anteriormente, al usar el SDK de OpenAI conectado a través de un servidor proxy de LiteLLM, era posible perder el reporte de los datos de respuesta del LLM debido a la falta de un motivo de finalización. Esto se ha corregido, y la respuesta ahora siempre debe registrarse.

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 elimina el soporte para la función Lambda de Python en el archivo de configuración, excluye el encabezado newrelic de forma predeterminada, agrega soporte para las configuraciones de exclusión e inclusión para las trazas del agente híbrido, la instrumentación de anthropic, la transmisión de respuestas de gemini, mejora el almacenamiento en caché de IS_PYPY en gc_data.py para el rendimiento y agrega el atributo http.statusCode en los eventos de transacción. Esta versión también reenvía módulos durante la reconexión asegurando que se registren, protege las métricas de recolección de basura contra llamadas reentrantes, corrige la propagación de tareas en generadores asíncronos y la propagación del contexto de starlette en StreamingResponse.

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

• Eliminar el soporte para las funciones Lambda de Python en el archivo de configuración

  • Anteriormente, el agente permitía especificar una función Lambda de Python para nombrar dinámicamente transacciones, tarea en segundo plano, traza de base de datos, traza de perfil, URL y método de traza externa, traza de función, traza de generador y traza de memcache. Dado que el soporte para esta característica expone una vulnerabilidad de seguridad en el agente, esta característica se está eliminando.

Desusos

• El atributo response.status en WebTransactions se considera obsoleto y se eliminará en la próxima versión 14.0.0. Está siendo reemplazado por http.statusCode. Recomendamos reemplazar todas las referencias a response.status por http.statusCode.

Nueva característica

• Excluir el encabezado newrelic por defecto

  • El encabezado de rastreo distribuido newrelic ya no se envía por defecto. Solo se enviarán los encabezados traceparent y tracestate de W3C.

• Agregar configuraciones de exclusión e inclusión para las trazas del agente híbrido

  • opentelemetry.traces.include para el archivo de configuración o NEW_RELIC_OPENTELEMETRY_TRACES_INCLUDE para usarse como variable de entorno
  • opentelemetry.traces.exclude para el archivo de configuración o NEW_RELIC_OPENTELEMETRY_TRACES_EXCLUDE para usarse como variable de entorno

  El comportamiento predeterminado del agente híbrido también será diferente. Ahora, solo las bibliotecas y los rastreadores compatibles con OpenTelemetry pero que aún no son compatibles con New Relic utilizarán la instrumentación de OpenTelemetry. De lo contrario, el agente utilizará por defecto los hooks de instrumentación de New Relic.

  Puede encontrar más información sobre estos ajustes en la página de configuración del agente de Python, así como en la página de soporte de la API de OpenTelemetry.

• Agrega instrumentación de streaming de Anthropic

  • Agrega soporte de instrumentación para anthropic.

• Mejorar el almacenamiento en caché de IS_PYPY en gc_data.py para un mejor rendimiento

• Ahora verifica y almacena en caché IS_PYPY una vez cuando se carga el módulo.

• Agregar transmisión de respuestas de Gemini

  • Agrega soporte para streaming de respuestas a Gemini a través del paquete google-genai.

• Agregar el atributo http.statusCode a los eventos de transacción

  • Para estar en conformidad con el resto de los agentes de lenguaje, el agente de Python ahora envía el estado http al atributo WebTransaction http.statusCode. El agente de Python continuará enviando el atributo a response.status también, pero el atributo response.status se eliminará en el futuro.

Errores

• Reenviar módulos durante la reconexión

  • El agente anteriormente solo enviaba la lista de módulos periódicamente después del primer ciclo de conexión. Si el agente se reconectara al recolector, estos datos no se volverían a enviar, por lo que la UI ya no mostraría los datos del módulo. Esto ya fue solucionado.

• Proteger las métricas de recolección de basura contra llamadas reentrantes

  • Agrega un indicador para evitar llamadas reentrantes a _GCDataSource.record_gc() y prevenir la recursión infinita en Python 3.13+.

• Habilitar la propagación de tareas en generadores asíncronos

  • Soluciona un problema en el que AsyncGeneratorProxy no manejaba correctamente la propagación del contexto de la transacción si se distribuía en varias tareas.

• Corregir la propagación del contexto de Starlette en StreamingResponse

  • Agrega la propagación del contexto de traza a starlette StreamingResponse tanto para generadores sincrónicos como asincrónicos.

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.