Python agent release notesRSS

Notes

This release of the Python agent adds trace/span support for Hybrid Agent, New Relic's integration with OpenTelemetry. It also adds entity GUIDs to Agent Control health check files, subcomponent attributes to agentic AI instrumentation, support for new Redis client methods, fixes a bug where there may be duplicate ImportHookFinder instances and a bug in OracleDB Cursor.callproc() 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.

Features

• Add Hybrid Agent tracing support

  • Hybrid Agent is designed to bridge the gap for teams looking to adopt OpenTelemetry standards while maintaining backwards compatibility with their existing New Relic dashboards. Hybrid Agent offers a "best-of-both-worlds" experience by combining New Relic’s deep visibility with OpenTelemetry API compatibility. It provides an observability solution with integrated support for the following OpenTelemetry APIs:
    • Tracing
    • Standalone library and native framework instrumentation
  • Key enhancements like Span Links and Events on Spans are now available, ensuring seamless interoperability in mixed-mode environments.

• Introduces a new Trace ID Ratio based sampler

  • A new Trace ID Ratio based sampler. This sampling algorithm is based off the sampler of the same name from OpenTelemetry, and can be configured to sample a set percentage of transactions.

• Add subcomponent attributes to agentic AI instrumentation

  • Instrumentation for LangChain, MCP, and Strands 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.

• Add entity GUID to Agent Control health check files

  • When the agent is started within an Agent Control environment, a health check file is created at the configured file location for every agent process. This file now includes the GUID of the entity related to the agent when available.

• Add instrumentation for new Redis methods

  • Add instrumentation for the following methods new methods on Redis clients:
    • hotkeys_get
    • hotkeys_reset
    • hotkeys_start
    • hotkeys_stop
    • vrange
    • xcfgset

Bugs

• Fix duplicate ImportHookFinder instances

  • Previously it was possible for duplicates of the import hook finder to be added to sys.meta_path.

• Fix incorrect signature on OracleDB Cursor.callproc()

  • Previously attempting to use keyword arguments with Cursor.callproc() would cause crashes as the argument names were incorrect in our instrumentation. This has been fixed, and the additional argument keyword_parameters is now also supported.

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.

Notes

This release of the Python agent adds support for LangGraph agents.

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 LangGraph agents

  • Adds instrumentation for LangGraph agent invocations via create_agent() in LangChain. This includes agent calls to invoke(), ainvoke(), stream(), and astream().

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 versão do agente Python adiciona novas formas de passar erros para notice_error(), adiciona suporte para captura de erros de ferramentas síncronas Strands-Agent, adiciona suporte para gpt-5 e modelos OpenAI LLM mais recentes e corrige uma falha na lógica de utilização do Azure Functions.

Instale o agente usando easy_install/pip/distribute através do Índice de Pacotes Python, usando conda através do Índice de Pacotes Conda-Forge ou baixe-o diretamente do site de download do New Relic.

Recurso

• Adicionar suporte para instâncias de exceção como argumentos para notice_error()

  • notice_error() agora pode aceitar uma instância de exceção capturada (como uma de um bloco try/except) para o argumento error, em vez de uma tupla de exceção de sys.exc_info().

  • Isso é adicional e não substitui o comportamento existente. O uso anterior de notice_error() com zero argumentos ou com uma tupla de exceção ainda deve funcionar corretamente.

• Adicionar suporte para gpt-5 e modelos OpenAI LLM mais recentes

  • Adicionar atualizações à instrumentação OpenAI para suportar nomes de atributos mais recentes usados com modelos OpenAI posteriores

• Adicionar suporte para captura de erros de ferramentas síncronas Strands-Agent

  • Funções Python síncronas usadas como ferramentas em Strands-Agents agora têm captura de erros adequada e capturam rastreamentos em ferramentas como pesquisas de banco de dados.

Correções de bugs

• Proteção contra falhas na utilização do Azure Functions

  • Anteriormente, alguns usuários enfrentavam casos extremos em que a detecção de utilização do Azure Functions travava ao tentar corresponder expressões regulares. A falha foi corrigida e não deverá mais ser possível no futuro.

Declaração de apoio

Recomendamos atualizar para a versão mais recente do agente assim que estiver disponível. Se você não puder atualizar para a versão mais recente, atualize seu agente para uma versão com no máximo 90 dias. Saiba mais sobre como manter o agente atualizado.

Consulte a New Relic Python política de fim de vida útil do agente para obter informações sobre lançamentos de agentes e datas de suporte.

Notas

Esta versão do agente Python adiciona suporte para o seguinte:

• Fios
• AWS Bedrock Converse Streaming
• Métodos Redis hybrid_search e msetex
• Atribuição de funções LangChain para o evento LLM
• timestamp do evento LLM capturado no momento da solicitação do LLM.
• loop_factory parâmetro em asyncio.Runner

Esta versão também corrige um bug na instrumentação ASGI, onde os cabeçalhos não são relatados pelo servidor web.

Instale o agente usando easy_install/pip/distribute através do Índice de Pacotes Python, usando conda através do Índice de Pacotes Conda-Forge ou baixe-o diretamente do site de download do New Relic.

Recurso

• Adicionar suporte para Strands

  • Adicionar instrumentação para as ferramentas Strands e para o agente em configurações de agente único e multiagente (enxames, grafos, etc.).

• Adicionar suporte para AWS Bedrock Converse Streaming

  • Adicionar suporte para monitoramento da API de streaming da Converse. Isso inclui suporte para chamadas de conclusão de bate-papo Converse feitas com clientes boto3 e aioboto3 usando converse_stream().

• Adicionar suporte para métodos Redis

  • Adicionar suporte para os seguintes métodos:

    • hybrid_search
    • msetex

• Adicionar suporte para loop_factory em asyncio.Runner

  • No Python 3.11, a classe asyncio.Runner foi adicionada, assim como o parâmetro loop_factory. O parâmetro loop_factory fornece uma substituição para políticas de loop. Agora, o loop criado é instrumentado, independentemente de ser por meio de uma configuração de loop de eventos global ou de um loop de eventos personalizado.

• Capturar atribuições de funções do LangChain no evento LLM

  • O evento LangChain LlmChatCompletionMessage agora contém a função atribuída do LangChain.

• Registre timestamp do evento LLM no momento da solicitação do LLM.

  • Anteriormente, o timestamp do evento LLM era capturado no momento da criação do evento. Agora, essa informação é capturada com mais precisão no momento da solicitação do LLM.

Correções de bugs

• consumo de cabeçalho ASGI

  • Quando um ASGIWebTransaction consome os cabeçalhos de um evento http.response.start, ele o faz sem levar em consideração os tipos de entrada permitidos. Quando os cabeçalhos são um gerador, o gerador foi consumido pela chamada para process_response() não deixando cabeçalhos restantes para o servidor web enviar. O problema já foi resolvido.

Declaração de apoio

Recomendamos atualizar para a versão mais recente do agente assim que estiver disponível. Se você não puder atualizar para a versão mais recente, atualize seu agente para uma versão com no máximo 90 dias. Saiba mais sobre como manter o agente atualizado.

Consulte a New Relic Python política de fim de vida útil do agente para obter informações sobre lançamentos de agentes e datas de suporte.

Notas

Esta versão do agente Python adiciona suporte Python 3.14, novas variáveis de ambiente para configurações de filtro de atributos, suporte para geradores assíncronos em decoradores de transação, modelos adicionais no AWS Bedrock e novos métodos no AWS Kinesis. Esta versão também corrige um bug no aiomysql que causava RecursionError ao usar ConnectionPool onde ele era envolvido várias vezes, um bug onde as propriedades não eram passadas corretamente no produtor do kombu e um erro quando shutdown_agent é chamado de dentro da thread de colheita.

Instale o agente usando easy_install/pip/distribute através do Índice de Pacotes Python, usando conda através do Índice de Pacotes Conda-Forge ou baixe-o diretamente do site de download do New Relic.

Recurso

• Adicionar suporte para Python 3.14

  • Adicionar suporte para Python 3.14.

• Adicionar variáveis de ambiente para configurações de filtros de atributos

  • As seguintes configurações agora podem ser definidas por meio de variáveis de ambiente:

    Configuração	Variável de ambiente
    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

• Adicionar suporte para geradores assíncronos em decoradores de transação.

  • Anteriormente, os decoradores de transação não suportavam o encapsulamento em geradores assíncronos. Esse recurso foi adicionado e, agora, as transações do gerador assíncrono medirão automaticamente o tempo de espera do loop de eventos e outras estatísticas.

• Adicionar suporte para modelos adicionais na instrumentação do AWS Bedrock.

  • Atualiza a instrumentação do AWS Bedrock por meio do botocore e do aiobotocore para oferecer suporte aos seguintes modelos adicionais.

    • Modelos Claude Sonnet 3+
    • Modelos que são prefixados com uma região (com reconhecimento de região)

• Adicionar instrumentação para novos métodos Kinesis

  • Adiciona instrumentação botocore para dar suporte a novos métodos do AWS Kinesis.

    • describe_account_settings
    • update_account_settings
    • update_max_record_size
    • update_stream_warm_throughput

Correções de bugs

• Prevenir um erro de recursão no pool de conexões do aiomysql

  • Anteriormente, um RecursionError era gerado no aiomysql ao usar conexões agrupadas. Cadeias profundas ObjectProxy foram criadas em torno de conexões agrupadas devido ao enrolamento repetido. Isso já foi corrigido.

• Corrigido um bug em que as propriedades não eram passadas corretamente no produtor do Kombu.

  • Corrigido um bug onde a instrumentação para kombu.messaging.Producer.publish() estava fazendo com que as propriedades fossem aninhadas acidentalmente dentro do dicionário, fazendo com que as propriedades ficassem no lugar errado e não fossem lidas pelos pacotes subsequentes.

• Corrigir erro quando shutdown_agent é chamado de dentro da thread de colheita.

  • Anteriormente, um RuntimeError poderia ocorrer quando shutdown_agent era chamado de dentro do thread de colheita. Isso resolve o problema adicionando uma proteção para evitar a falha.

Declaração de apoio

Recomendamos atualizar para a versão mais recente do agente assim que estiver disponível. Se você não puder atualizar para a versão mais recente, atualize seu agente para uma versão com no máximo 90 dias. Saiba mais sobre como manter o agente atualizado.

Consulte a New Relic Python política de fim de vida útil do agente para obter informações sobre lançamentos de agentes e datas de suporte.