Python agent release notesRSS

Notes

This release of the Python agent adds support for time to first token and fixes an incompatible Flask add_url_rule function signature.

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.

New features

• Added time to first token for LLM response streams:

  • The agent records a new attribute,time_to_first_token on LlmChatCompletionSummary events for OpenAI and Bedrock response streams. This attribute measures the duration between the initial request and the first token received in the response.

Bugs fixes

• Resolved Flask add_url_rule function signature mismatch

  • Updated the instrumentation for Flask's to align its add_url_rule function signature with the native Flask implementation. This fix prevents potential application crashes caused by the previous signature mismatch.

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 remove o suporte para Cross Application Tracing (CAT), Python 3.8 e os certificados SSL empacotados. Também atualiza todos os pacotes de terceiros para suas versões mais recentes e adiciona suporte para CPython free-threaded, sistemas operacionais Windows e instrumentação aprimorada para Microsoft AG2 (Autogen). Além disso, esta versão inclui um novo extra opcional para instalar certificados SSL via certifi. Esta versão também corrige um bug na instrumentação do Strands Agents que fazia com que exceções duplicadas fossem reportadas.

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

• O Cross Application Tracing (CAT) foi removido em favor do Rastreamento Distribuído (DT).

  • O Cross Application Tracing (CAT) foi descontinuado na versão do agente 7.0.0.166 e foi removido nesta versão. Se você ainda estiver usando o Cross Application Tracing (CAT), recomendamos migrar para o Rastreamento distribuído (DT) o mais rápido possível para evitar interrupções.

• Os certificados SSL empacotados foram removidos.

  • Se você precisar de certificados para o seu ambiente, pode instalá-los via gerenciador de pacotes do seu sistema operacional ou instalar o agente com o extra opcional newrelic[certificates].

• O suporte ao Python 3.8 foi removido.

  • O Python 3.8 atingiu o fim da vida útil em 2024-10-07 e não é mais suportado pelo agente. Por favor, considere atualizar sua aplicação para uma versão suportada do Python para continuar recebendo atualizações do Agente Python.

Segurança

• Todos os pacotes internos atualizados para as versões mais recentes.

  • urllib3 atualizado para v2.6.3
    • Isso corrige todas as CVEs abertas no urllib3 até a data deste lançamento.
  • opentelemetry_proto atualizado para v1.40.0
  • wrapt atualizado para v2.1.2
  • asgiref atualizado para v3.11.1

Novo recurso

• Novo extra newrelic[certificates] para instalar certificados SSL via certifi.

  • O agente agora fornece um extra newrelic[certificates] opcional que pode ser usado para instalar os certificados SSL empacotados. Isso é destinado a usuários que precisam de certificados, mas não conseguem instalá-los via gerenciador de pacotes do sistema operacional.

• Suporte ao CPython free-threaded

  • A partir do Python 3.13, o CPython lança builds do Python com o Global Interpreter Lock (GIL) desativado, permitindo multithreading real.
  • Esta versão adiciona suporte a esse comportamento, permitindo que o agente seja executado com segurança em um ambiente free-threaded.
  • Este lançamento também inclui binários pré-compilados para CPython free-threaded no Linux e Windows, facilitando a instalação nesses ambientes.

• Suporte ao Windows

  • Esta versão inclui binários pré-compilados para CPython 3.13 ou superior no Windows.
  • Observe que o Python 3.12 ou inferior não é oficialmente suportado no Windows devido a grandes variações na resolução dos temporizadores. Ainda é possível instalar e usar o agente a partir do código-fonte, mas os usuários podem enfrentar problemas com dados de tempo imprecisos e devem atualizar para o Python 3.13 ou superior para ter a melhor experiência.

• Instrumentação aprimorada para Microsoft AG2 (Autogen)

  • Adicionado suporte a respostas de streaming por meio do método gerador assíncrono on_messages_stream().
  • A instrumentação agora inclui um atributo subcomponent em spans que representam chamadas de ferramenta ou agente. Isso é usado para fornecer um mapeamento de entidades mais aprimorado na interface do New Relic.

Bugs

• Exceções duplicadas no Strands Agents

  • Após uma atualização do Strands Agents que encapsula algumas exceções em um novo tipo EventLoopException, erros duplicados podem ser relatados. Isso foi corrigido e o erro subjacente deve ser reportado apenas uma vez.

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 a trace/span para o Agente Híbrido, a integração da New Relic com o OpenTelemetry. Também adiciona GUIDs de entidade aos arquivos de verificação de integridade do Agent Control, atributos subcomponent à instrumentação de IA agêntica, suporte a novos métodos de cliente Redis, corrige um bug onde pode haver instâncias duplicadas do ImportHookFinder e um bug na instrumentação do OracleDB Cursor.callproc().

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 ao rastreamento do Agente Híbrido

  • O Hybrid Agent foi projetado para preencher a lacuna para equipes que buscam adotar os padrões OpenTelemetry, mantendo a retrocompatibilidade com seus dashboards existentes do New Relic. O Hybrid Agent oferece uma experiência do "melhor dos dois mundos" ao combinar a visibilidade profunda da New Relic com a compatibilidade da API OpenTelemetry. Fornece uma solução de observabilidade com suporte integrado para as seguintes APIs do OpenTelemetry:

    • Rastreamento
    • Instrumentação de biblioteca autônoma e framework nativo

  • Principais melhorias como Span Links e Events on Spans estão agora disponíveis, garantindo interoperabilidade perfeita em ambientes de modo misto.

• Introduz um novo amostrador baseado na proporção de Trace ID

  • Um novo amostrador baseado na proporção de Trace ID. Este algoritmo de amostragem baseia-se no amostrador de mesmo nome do OpenTelemetry e pode ser configurado para amostrar uma porcentagem definida de transações.

• Adicionar subcomponent atributos à instrumentação de IA agêntica

  • A instrumentação para LangChain, MCP e Strands agora inclui um atributo subcomponent em spans que representam chamadas de ferramenta ou agente. Isso é usado para fornecer um mapeamento de entidades aprimorado na interface do usuário do New Relic.

• Adicionar o GUID da entidade aos arquivos de verificação de integridade do Agent Control

  • Quando o agente é iniciado em um ambiente de Controle do Agente, um arquivo de verificação de integridade é criado no local de arquivo configurado para cada processo do agente. Este arquivo agora inclui o GUID da entidade relacionada ao agente quando disponível.

• Adicionar instrumentação para novos métodos do Redis

  • Adicione instrumentação para os seguintes novos métodos nos clientes Redis:

    • hotkeys_get
    • redefinir_atalhos
    • hotkeys_start
    • Parar teclas de atalho
    • vrange
    • xcfgset

Bugs

• Corrigir instâncias duplicadas do ImportHookFinder

  • Anteriormente, era possível que duplicatas do localizador de gancho de importação fossem adicionadas a sys.meta_path.

• Corrigir assinatura incorreta no OracleDB Cursor.callproc()

  • Anteriormente, tentar usar argumentos nomeados com Cursor.callproc() causava falhas, pois os nomes dos argumentos estavam incorretos em nossa instrumentação. Isso foi corrigido, e o argumento adicional keyword_parameters agora também é suportado.

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 a agentes LangGraph.

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 a agentes LangGraph

  • Adiciona instrumentação para invocações de agente LangGraph via create_agent() no LangChain. Isso inclui chamadas do agente para invoke(), ainvoke(), stream() e astream().

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