Python agent release notesRSS

Notes

This release of the Python agent adds additional model information to LangChain Chain LLM events, and fixes a bug in LangGraph streaming 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

• Add additional model information to LangChain Chain LLM events

  • Add request.model and response.model attributes to LLM events produced by LangChain Chains.
  • This information is pulled on a best effort basis and may not always be available.

Bugs

• Fix TypeError in LangGraph streaming instrumentation

  • Previously, when using a subset of streaming APIs in LangGraph, the agent would encounter a TypeError due to the use of weakref.WeakMethod by LangGraph. This has been fixed, and the agent should now work correctly with those LangGraph streaming methods.

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 multiple new Redis commands, fixes a bug in LangGraph instrumentation, and improves handling and logging of harvest limit settings.

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

• Add instrumentation for new Redis v8.8.0 commands

  • Add instrumentation for the following new Redis commands from redis-py v8.8.0:
    • Misc commands: INCREX, XNACK
    • Array commands: ARCOUNT, ARDEL, ARDELRANGE, ARGET, ARGETRANGE, ARGREP, ARINFO, ARINSERT, ARLASTITEMS, ARLEN, ARMGET, ARMSET, ARNEXT, AROP, ARRING, ARSCAN, ARSEEK, ARSET

Bugs

• Fix crash in LangGraph instrumentation

  • Previously, when using LangGraph instrumentation, the agent would crash due to an issue with context propagation to jobs in AsyncBackgroundExecutor. This has been fixed, and the agent should now work correctly with LangGraph.

• Improved handling and logging of harvest limit settings

  • The agent now more accurately reports the list of harvest methods and limits to the Environment tab in New Relic One.
  • The agent now has more consistent debug logging on startup for harvest limit settings.

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 corrige um problema de propagação de contexto no LangChain e no LangGraph, um problema de gravação de conclusão de chat da OpenAI e um problema ao usar o streaming da OpenAI(https://pypi.org/project/openai) por meio do LiteLLM como proxy.

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.

Bugs

• Corrigir a propagação de contexto no LangChain e LangGraph

  • Adiciona propagação adicional de contexto de transação ao LangChain e ao LangGraph para oferecer suporte a uma variedade maior de estruturas de aplicativo.

• Corrigir um problema de gravação de chat completion da OpenAI

  • OpenAI reintroduziu a lógica que encerra a resposta de streaming mesmo que o consumidor não tenha lido todos os dados. Anteriormente, os dados de chat completion eram registrados apenas ao atingir o final do stream, o que resultava em dados de chat completion não serem registrados no fechamento do stream. Agora foi adicionada uma lógica para capturar os dados de conclusão do chat, mesmo que o stream não tenha sido totalmente lido.

• Corrige um problema ao usar o streaming da OpenAI através do LiteLLM como proxy

  • Anteriormente, ao usar o SDK da OpenAI conectado através de um servidor proxy LiteLLM, era possível perder o relatório de dados de resposta do LLM devido à falta de um motivo de conclusão. Isso foi corrigido, e a resposta agora deve ser sempre registrada.

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 remove o suporte para a função do Lambda do Python no arquivo de configuração, exclui o cabeçalho newrelic por padrão, adiciona suporte para as configurações de exclusão e inclusão para trace do Hybrid Agent, para a instrumentação do anthropic, para o streaming de resposta do gemini, melhora o cache de IS_PYPY em gc_data.py para desempenho e adiciona o atributo http.statusCode em eventos de transação. Esta versão também reenvia módulos durante a reconexão, garantindo que sejam registrados, protege as métricas de coleta de lixo contra chamadas reentrantes, corrige a propagação de tarefas em geradores assíncronos e a propagação de contexto do starlette em StreamingResponse.

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 removido

• Remover o suporte a funções do Lambda em Python no arquivo de configuração

  • Anteriormente, o agente permitia especificar uma função do Lambda em Python para nomear dinamicamente transações, tarefa em segundo plano, trace de banco de dados, trace de perfil, URL e método de trace externo, trace de função, trace de gerador e trace de memcache. Como o suporte a este recurso expõe uma vulnerabilidade de segurança no agente, este recurso está sendo removido.

Depreciações

• O atributo response.status em WebTransactions é considerado obsoleto e será removido na próxima versão 14.0.0. Está sendo substituído por http.statusCode. Recomendamos substituir todas as referências a response.status por http.statusCode.

Novo recurso

• Excluir o cabeçalho newrelic por padrão

  • O cabeçalho newrelic de distributed tracing não é mais enviado por padrão. Apenas os cabeçalhos W3C traceparent e tracestate serão enviados.

• Adicionar configurações de exclusão e inclusão para traces do Agente Híbrido

  • opentelemetry.traces.include para o arquivo de configuração ou NEW_RELIC_OPENTELEMETRY_TRACES_INCLUDE ser usado como variável de ambiente
  • opentelemetry.traces.exclude para o arquivo de configuração ou NEW_RELIC_OPENTELEMETRY_TRACES_EXCLUDE ser usado como variável de ambiente

  O comportamento padrão do agente híbrido também será diferente. Agora, apenas bibliotecas e tracers que são suportados pelo OpenTelemetry, mas que ainda não são suportados pelo New Relic, utilizarão a instrumentação do OpenTelemetry. Caso contrário, o agente usará por padrão os hooks de instrumentação da New Relic.

  Mais informações sobre essas configurações podem ser encontradas na página de configuração do agente Python, bem como na página de suporte à API do OpenTelemetry.

• Adicionar instrumentação de streaming da Anthropic

  • Adiciona suporte de instrumentação para anthropic.

• Melhorar o cache de IS_PYPY em gc_data.py para desempenho

• Agora verifica e armazena em cache IS_PYPY uma vez quando o módulo é carregado.

• Adicionar streaming de resposta do Gemini

  • Adicionar suporte a streaming de resposta ao Gemini por meio do pacote google-genai.

• Adicionar atributo http.statusCode a eventos de transação

  • Para estar em conformidade com os demais agentes de linguagem, o agente Python agora envia o status http para o atributo WebTransaction http.statusCode. O agente Python continuará enviando o atributo para response.status também, mas o atributo response.status será removido no futuro.

Bugs

• Reenviar módulos durante a reconexão

  • O agente anteriormente só enviava a lista de módulos periodicamente após o primeiro ciclo de conexão. Se o agente se reconectasse ao coletor, esses dados não seriam reenviados, portanto a interface não exibiria mais os dados do módulo. O problema já foi resolvido.

• Proteger métricas de garbage collection contra chamadas reentrantes

  • Adiciona uma flag para evitar chamadas reentrantes para _GCDataSource.record_gc() para evitar recursão infinita no Python 3.13+.

• Habilitar a propagação de tarefas em geradores assíncronos

  • Corrige um problema em que AsyncGeneratorProxy não tratava corretamente a propagação de contexto de transação se distribuída por várias tarefas.

• Corrigir a propagação de contexto do Starlette em StreamingResponse

  • Adiciona a propagação de contexto do trace ao starlette StreamingResponse tanto para geradores síncronos quanto assíncronos.

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 tempo até o primeiro token e corrige uma assinatura de função add_url_rule incompatível do Flask.

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.

Novo recurso

• Adicionado o tempo até o primeiro token para streams de resposta de LLM:

  • O agente registra um novo atributo,time_to_first_token em eventos LlmChatCompletionSummary para streams de resposta da OpenAI e do Bedrock. Este atributo mede a duração entre a requisição inicial e o primeiro token recebido na resposta.

Correções de bugs

• Resolvida a incompatibilidade de assinatura da função add_url_rule do Flask

  • Atualizada a instrumentação do Flask para alinhar a assinatura de sua função add_url_rule com a implementação nativa do Flask. Esta correção evita possíveis falhas na aplicação causadas pela incompatibilidade de assinatura anterior.

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.