Notes
This release of the Python agent enables AI monitoring by default with the new ai_monitoring.basic_telemetry.enabled setting, deprecates the ai_monitoring.enabled setting, and fixes a crash in LangChain tool 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.
Changes
AI monitoring is now enabled by default
- LLM instrumentation is now enabled by default and the agent sends
Llm*custom events, spans, and metrics (without message content) unless configured otherwise. - To record prompt and response content, set
ai_monitoring.record_content.enabledtotrue. - To opt out, set
ai_monitoring.basic_telemetry.enabledtofalsein newrelic.ini, or set the environment variableNEW_RELIC_AI_MONITORING_BASIC_TELEMETRY_ENABLED=false. - The
ai_monitoring.enabledsetting and theNEW_RELIC_AI_MONITORING_ENABLEDenvironment variable are deprecated, but setting either one tofalsealso opts out of AI Monitoring.
- LLM instrumentation is now enabled by default and the agent sends
Bug fixes
- Fixed a crash in LangChain
StructuredTool.invokeandStructuredTool.ainvokeinstrumentation whenconfigor itsmetadatawasNone.
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 instrumentação para o framework de agente da Microsoft e CrewAI, melhora a instrumentação de flag de recurso do LaunchDarkly e o suporte ao encaminhamento de span, e corrige várias falhas.
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 framework de agente da Microsoft
- Foi adicionada instrumentação para ferramentas e agentes no pacote
agent-framework. - As configurações de múltiplos agentes ainda não estão instrumentadas.
- Foi adicionada instrumentação para ferramentas e agentes no pacote
Nova instrumentação para o CrewAI
- Foi adicionada instrumentação para agentes, equipes e ferramentas no pacote
crewai.
- Foi adicionada instrumentação para agentes, equipes e ferramentas no pacote
Recursos aprimorados
Integração aprimorada de flag de recurso do LaunchDarkly.
visualização
Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!
Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas políticas de pré-lançamento.
Para aderir à nossa integração em prévia pública com o LaunchDarkly, habilite as configurações
launch_darkly_integration.enabledeopentelemetry.enabledno seu arquivo de configuração.Instrumentação aprimorada de flag de recurso no ldclient.
- Adicionado o novo atributo
feature_flag.url.fullpara habilitar o deep linking na interface. - Alterada a capitalização da chave
inExperimentpara corresponder ao LaunchDarkly. - Adicionado suporte para valores falsy em atributos de flag de recurso.
- Reduzidos todos os avisos de integração do LaunchDarkly para serem exibidos apenas uma vez.
- Adicionado o novo atributo
Encaminhamento de span aprimorado para o ldobserve.
- Adicionados os atributos de span
nr.entity.guidenr.entity.urlpara habilitar o deep linking na interface. - Corrigida a hierarquia de span para permitir o aninhamento adequado na interface.
- Adicionados os atributos de span
Correções de bugs
- Corrigida uma falha em
TimeTracequando attributes eraNoneem_add_span_event_event. - Corrigida uma falha no wrapper
Configdo LaunchDarkly ao reverter para os valores padrão.
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 instrumentação para OpenAI Responses e o novo comando hsetex no Valkey.
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 respostas da OpenAI
- A instrumentação foi adicionada para os métodos
client.responsesdo SDKopenai, que têm como destino a API Responses. - Esta é uma adição à instrumentação existente dos métodos
client.chat.completionsmais antigos e da API Chat Completions, que ainda são suportados.
- A instrumentação foi adicionada para os métodos
Recursos aprimorados
Adicionado suporte para novo comando do Valkey:
- O comando
hsetexagora é suportado.
- O comando
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 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_strategyagora é suportado no Kinesis.
- O método
Adicionada a integração com o LaunchDarkly em versão prévia pública.
visualização
Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!
Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas políticas de pré-lançamento.
- Para aderir à nossa integração em prévia pública com o LaunchDarkly, habilite as configurações
launch_darkly_integration.enabledeopentelemetry.enabledno seu arquivo de configuração.
- Para aderir à nossa integração em prévia pública com o LaunchDarkly, habilite as configurações
Atualizações de segurança
O pacote interno urllib3 foi atualizado para
2.8.0para resolver todas as CVEs atuais emurllib3.- 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
httplibpoderia produzir cabeçalhos duplicados paratraceparent, resultando em um valor malformado.
- Foram corrigidos problemas em que a instrumentação de
setup.pyo arquivo de instalação agora funciona para todas as versões suportadas do Python- Se um usuário quisesse usar o arquivo
setup.pydiretamente para instalar o agente Python no Python 3.12 e superior, ele se depararia com umImportError. Isso ocorre porquedistutilsfoi descontinuado desde o Python 3.10 e totalmente removido da biblioteca padrão no Python 3.12.
- Se um usuário quisesse usar o arquivo
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.
Notes
This release of the Python agent adds support for OpenSearch, Microsoft Azure SQL, new Kinesis methods, and a new browser_monitoring.version setting. Additionally, improvements have been made to Anthropic, MCP, and Google ADK instrumentation. Issues with signed headers in botocore (SigV4) and Gemini tools parsing have also been fixed for this release.
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 opensearch-py
- Instrumentation was added for the official OpenSearch database connector.
New instrumentation for mssql-python
- Instrumentation was added for Microsoft Azure SQL.
New instrumentation for new Kinesis methods
- The following methods are now supported in Kinesis:
create_channeldelete_channeldescribe_channellist_channelsupdate_channel
- The following methods are now supported in Kinesis:
New setting for
browser_monitoring.version- The new setting
browser_monitoring.versionenables users to specify specific versions of our Browser Monitoring Agent to be injected. - See the list of Supported Browser Agent Versions to choose from.
- The new setting
Improved Features
Improved support for anthropic.
- Improved parsing of request parameters for the Anthropic SDK on versions 1.0.0 and above.
- New parsing for responses via
Messages.with_raw_response.createenabling improved compatibility with LangChain.
Support for mcp v2.0.0 and above.
- Instrumentation has been updated following the major refactor done in
mcpv2.0.0 and should once again work as expected.
- Instrumentation has been updated following the major refactor done in
Support for Google ADK v2.9.0 and above.
- Instrumentation has been updated for Google ADK on versions 2.9.0 and above.
Bugs
Fix issues with signed headers in botocore (SigV4)
- Previously any distributed tracing headers that were generated by other tracing libraries could cause issues with instrumentation in botocore due to header signing. This has been fixed, and distributed tracing headers are now mutated before signing.
Fix Gemini tools parsing
- Previously, some instances of tools created with Gemini would fail to parse and would silently fail, resulting in no response for that specific request. This has been fixed.
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.