Python agent release notesRSS

Notes

This release of the Python agent adds instrumentation for OpenAI Responses, and the new hsetex command in Valkey.

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

• New instrumentation for OpenAI Responses

  • Instrumentation was added for the openai SDK's client.responses methods, which target the Responses API.
  • This is an addition to the existing instrumentation of the older client.chat.completions methods and Chat Completions API, which are still supported.

Enhanced features

• Added support for new Valkey command:

  • The hsetex command is now 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.

Notas

Esta versão do agente Python adiciona utilização para o Azure App Services, instrumentação para o Azure Service Bus, suporte para um novo método Kinesis e suporte para o Google ADK para a v2.10.0 e superior. Esta versão também corrige um problema no httplib em que os cabeçalhos de distributed trace eram duplicados, bem como o arquivo de instalação setup.py.

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.

Recursos removidos

• Removido o suporte ao Python 3.9

  * O Python 3.9 atingiu o fim da vida útil em 31 de outubro de 2025 e não é mais suportado pelo agente. Considere atualizar seu aplicativo para uma versão suportada do Python para continuar recebendo atualizações do agente Python.

Novo recurso

• Utilização do Azure App Service

  • A utilização para o Azure App Service foi adicionada para permitir o mapeamento de relacionamento de entidade.
  • Isso também adiciona uma nova configuração, utilization.detect_azureappservice

• Nova instrumentação para o Azure Service Bus

  • A instrumentação foi adicionada para o Microsoft Azure Service Bus.

• Nova instrumentação para novo método do Kinesis

  • O método update_stream_record_distribution_strategy agora é suportado no Kinesis.

Atualizações de segurança

• O pacote interno urllib3 foi atualizado para 2.8.0 para resolver todas as CVEs atuais em urllib3.

  • Isso resolve todas as CVEs conhecidas no agente até o momento.

Recursos aprimorados

• Suporte para o Google ADK v2.10.0 e superior.

  • A instrumentação foi atualizada para o Google ADK nas versões 2.10.0 e superiores.

Bugs

• Cabeçalhos de distributed tracing duplicados em httplib

  • Foram corrigidos problemas em que a instrumentação de httplib poderia produzir cabeçalhos duplicados para traceparent, resultando em um valor malformado.

• setup.py o arquivo de instalação agora funciona para todas as versões suportadas do Python

  • Se um usuário quisesse usar o arquivo setup.py diretamente para instalar o agente Python no Python 3.12 e superior, ele se depararia com um ImportError. Isso ocorre porque distutils foi descontinuado desde o Python 3.10 e totalmente removido da biblioteca padrão no Python 3.12.

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 corrige problemas com cabeçalhos assinados no botocore (SigV4).

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

• Corrige problemas com cabeçalhos assinados no botocore (SigV4)

  • A alteração anterior nos cabeçalhos de distributed tracing do botocore foi revertida para evitar o envio de cabeçalhos duplicados.
  • Anteriormente, quaisquer cabeçalhos de distributed tracing que fossem gerados por outras bibliotecas de rastreamento poderiam causar problemas com a instrumentação no botocore devido à assinatura de cabeçalho. Isso foi corrigido desativando a assinatura para esses cabeçalhos no botocore.

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 OpenSearch, Microsoft Azure SQL, novos métodos do Kinesis e uma nova configuração browser_monitoring.version. Além disso, foram feitas melhorias na instrumentação do Anthropic, MCP e Google ADK. Problemas com cabeçalhos assinados no botocore (SigV4) e na análise de ferramentas do Gemini também foram corrigidos para esta versão.

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

• Nova instrumentação para o opensearch-py

  • Foi adicionada instrumentação para o conector oficial do banco de dados OpenSearch.

• Nova instrumentação para mssql-python

  • A instrumentação foi adicionada para o Microsoft Azure SQL.

• Nova instrumentação para novos métodos do Kinesis

  • Os seguintes métodos agora são suportados no Kinesis:

    • create_channel
    • delete_channel
    • describe_channel
    • list_channels
    • update_channel

• Nova configuração para browser_monitoring.version

  • A nova configuração browser_monitoring.version permite que os usuários especifiquem versões específicas do nosso agente de monitoramento de Browser a serem injetadas.
  • Consulte a lista de Versões suportadas do agente do browser para escolher.

Recursos Melhorados

• Suporte aprimorado para anthropic.

  • Análise aprimorada de parâmetros de solicitação para o Anthropic SDK nas versões 1.0.0 e superiores.
  • Nova análise para respostas via Messages.with_raw_response.create permitindo melhor compatibilidade com o LangChain.

• Suporte para mcp v2.0.0 e superior.

  • A instrumentação foi atualizada após a grande refatoração feita no mcp v2.0.0 e deve voltar a funcionar como esperado.

• Suporte para Google ADK v2.9.0 e superior.

  • A instrumentação foi atualizada para o Google ADK nas versões 2.9.0 e superiores.

Bugs

• Corrige problemas com cabeçalhos assinados no botocore (SigV4)

  • Anteriormente, quaisquer cabeçalhos de distributed tracing que fossem gerados por outras bibliotecas de rastreamento poderiam causar problemas com a instrumentação no botocore devido à assinatura de cabeçalho. Isso foi corrigido, e os cabeçalhos de distributed tracing agora são modificados antes da assinatura.

• Correção para análise de ferramentas do Gemini

  • Anteriormente, algumas instâncias de ferramentas criadas com o Gemini apresentavam falha de análise e falhavam silenciosamente, resultando em nenhuma resposta para essa solicitação específica. O problema 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 para o Azure CosmosDB, adiciona instrumentação para HTTPX2 e novas APIs de eventos de streaming do LangChain/LangGraph, adiciona suporte para convenções semânticas de banco de dados mais recentes do OpenTelemetry e resolve vários problemas, incluindo relatórios de pacotes incompletos, uma penalidade de desempenho de pesquisa de pacotes e um bug de relatório de nome de banco de dados MySQL.

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 suporte para Azure CosmosDB

  • O agente Python agora está instrumentado para as operações de cliente do Azure Cosmos DB, relatando métricas e traces de armazenamento de dados para operações de banco de dados, contêiner e usuário realizadas por meio do SDK azure-cosmos.

• Adicionado suporte para HTTPX2

  • O agente Python agora oferece suporte ao HTTPX2, um fork do HTTPX mantido ativamente pela equipe do Pydantic. A instrumentação de chamadas externas para HTTPX2 reflete o suporte existente do agente ao HTTPX para clientes síncronos e assíncronos.

• Adicionada instrumentação de eventos de streaming do LangChain/LangGraph

  • Adicionado suporte à instrumentação de astream_events para agentes do LangChain.
  • Adicionada instrumentação de stream_events/astream_events para LangChain/LangGraph v3, cobrindo a iteração sobre objetos GraphRunStream.

• Suporte adicionado para convenções semânticas de banco de dados mais recentes do OpenTelemetry

  • Ao executar o agente Python junto com o OpenTelemetry (modo de agente híbrido), o agente agora lê os nomes de atributo de span de banco de dados do OpenTelemetry legados e mais recentes (db.name/db.namespace, db.statement/db.query.text, db.mongodb.collection/db.collection.name), para que o rastreamento de banco de dados continue a funcionar corretamente, independentemente de qual versão de convenção semântica a biblioteca de instrumentação do OpenTelemetry emite.

Bugs

• Corrigido o relato incompleto de pacotes para o New Relic

  • Anteriormente, o agente Python podia omitir alguns pacotes instalados dos dados de ambiente relatados ao New Relic se a descoberta de módulos levasse mais tempo do que a janela de tempo fixa alocada durante o ciclo de coleta lento, e a lista de pacotes não fosse atualizada após a reinicialização do agente. A captura de pacotes agora é executada durante o ciclo de coleta rápido e é totalmente recapturada no encerramento/reinicialização do agente, para que a lista de pacotes relatada fique completa.

• Sobrecarga reduzida de pesquisas de versão de pacote

  • Anteriormente, a pesquisa de versões de pacotes instalados verificava novamente o sistema de arquivos para cada pacote em cada pesquisa, incorrendo em uma penalidade de tempo O(n^2) que aumentava com o número de pacotes instalados durante a inicialização do agente. O resultado de importlib.metadata.packages_distributions() agora é armazenado em cache após a primeira pesquisa para evitar essa sobrecarga.

• Corrigido get_linking_metadata para passar corretamente pelo aplicativo especificado

  • Anteriormente, a chamada de newrelic.agent.get_linking_metadata(application=...) ignorava o argumento application e sempre retornava metadados de vinculação para o aplicativo padrão. Isso afetava processos que se reportavam a mais de um aplicativo. O aplicativo especificado agora é repassado corretamente.
  • Obrigado ckarnell pela contribuição!

• Corrigido o relato do nome do banco de dados MySQL ao usar o argumento de palavra-chave database

  • Anteriormente, o agente verificava apenas o argumento de palavra-chave legado db ao analisar o nome do banco de dados dos argumentos de conexão do mysql-connector-python, de modo que as conexões feitas usando o argumento de palavra-chave moderno database não relatavam nenhum nome de banco de dados nas métricas de armazenamento de dados. O agente agora verifica database primeiro, recorrendo a db.

• Aviso corrigido ao acessar valores GraphOutput do LangGraph v1.1+

  • Anteriormente, a instrumentação do LangGraph v1.1+ acessava os valores de retorno GraphOutput usando a sintaxe de acesso a itens obsoleta, acionando um aviso de descontinuação. O agente agora lê GraphOutput.value diretamente.

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.