Python agent release notesRSS

Notes

This release of the Python agent adds support for the following:

• Custom tasks in Celery
• Graphene-Django monitoring
• Middleware filtering in Django
• AWS Bedrock Converse API
• W3CTraceParent header sampled flag

This release also provides the following fixes:

• Safeguards for the deepest unique path in GraphQL
• Safeguards for web URL request parsing
• Fallback for ElasticSearch and GraphQL when trace.settings==None
• Remove options method from async ElasticSearch client list

Install the agent using easy_install/pip/distribute via the Python Package Index or download it directly from the New Relic download site.

New features

• Adds support for custom tasks in Celery

  • Add monitoring support for custom task classes in Celery. Previously, only tasks using the default task class were able to be monitored. Note: This version of the Python agent will no longer support Celery versions less than v5.2.0.

• Adds support for Graphene-Django

  • Add monitoring support for synchronous schemas created with Graphene-Django. Previously, schemas created with Graphene-Django would only be partially monitored, resulting in missing GraphQL related attributes.

• Adds support for middleware filtering in Django

  • Users are now able to filter which Django middleware to monitor. There are now three additional settings:

    • instrumentation.middleware.django.enabled (Default is true)
    • instrumentation.middleware.django.exclude
    • instrumentation.middleware.django.include

  See the Django Middleware Filtering page for more information and examples.

• Adds support for AWS Bedrock Converse API

  • Add monitoring support for non-streaming Converse API. This includes support for converse chat completion calls made using boto3 and aioboto3 clients.

• Adds support for W3CTraceParent header sampled flag

  • When an upstream service sends the W3CTraceParent header with the sampling flag set, New Relic will take into account that sampling decision when deciding whether the current transaction will be sampled.

• Added support for sampling decisions based on whether the remote parent is sampled

  • Added support for two new configuration options:

    • distributed_tracing.sampler.remote_parent_sampled
    • distributed_tracing.sampler.remote_parent_not_sampled

  • default is the default behavior and behaves as it did before this change (it passes the sampling decision to the adaptive sampling algorithm to determine whether the transaction will be sampled).

  • always_on means that the trace that has a remote parent sampled or remote parent not sampled will always be sampled.

  • always_off means that the trace that has a remote parent sampled or remote parent not sampled will never be sampled.

Bug fixes

• Add safeguard for deepest unique path in GraphQL

  • Some users were experiencing issues with the deepest unique path in GraphQL not being generated due to a field name returning None. This issue has been fixed.

• Add safeguard for web request parsing

  • Some users experienced a parsing error when request_uri was malformed or contained invalid characters. This can happen at this point if the request_uri in the request header is invalid and does not match the (valid) URL originally given. While this safeguard has now been put in place in New Relic, urllib has resolved this issue for versions of Python released after Jan 31, 2025.

• Fix crash in ElasticSearch and GraphQL when trace.settings==None

  • In cases where trace.settings is None, the instrumentation for ElasticSearch crashed the application. A global_settings fallback has been put in place. This also resolves the same issue found in GraphQL.

• Remove options method from async ElasticSearch client list

  • The previous instrumentation of ElasticSearch caused a crash because options was in the list of async methods. This method is no longer wrapped in a DatastoreTrace since it is not one that conducts any datastore operations/requests.

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 suporte para novas funções Redis , converte todos os caminhos internos de os.path para pathlib.Path e corrige um problema com a codificação JSON de PosixPaths.

Instale o agente usando easy_install/pip/distribute por meio do Índice de Pacotes Python ou baixe-o diretamente do site de download do New Relic.

Novo recurso

• Adiciona suporte para novas funções do Redis

  • Adicione instrumentação para novas funções do Redis .

• Converta todos os caminhos internos de os.path para pathlib.Path

  • Converta todo o uso interno de caminhos baseados em strings e os.path para pathlib.Path em preparação para oferecer suporte a caminhos do Windows.

Correções de bugs

• Corrigir problema com codificação JSON PosixPath

  • Alguns usuários estavam tendo problemas com a codificação JSON PosixPath configurações de configuração. Este problema foi corrigido.

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 oracledb, corrige um bug no Kombu e no Kafka onde o objeto MessageTransaction não tem atributo destination_name e corrige o desaparecimento de metadados de utilização com a AWS.

Instale o agente usando easy_install/pip/distribute por meio do Índice de Pacotes Python ou baixe-o diretamente do site de download do New Relic.

Novo recurso

• Adiciona suporte para oracledb

  • Adicione instrumentação para oracledb.

Correções de bugs

• Corrigir o bug "MessageTransaction objeto não tem atributo destination_name"

  • Corrige um bug na instrumentação do MessageBroker onde os métodos de serialização estavam procurando o atributo destination_name no MessageTransaction e ele não existia.

• Corrigir problema de metadados de utilização da AWS ao executar AWS e K8s juntos

  • Devido às configurações de permissões no pod K8s em execução em instâncias do EC2 da AWS, o cache de utilização pode ser recuperado na primeira vez. Entretanto, se o aplicativo for deixado em execução continuamente, o agente será reconectado e os metadados de utilização não serão carregados. Em casos como esses, os metadados de utilização são armazenados em cache por instância do agente e podem ser recuperados.

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 Azure Function Apps e protobuf v6.

Instale o agente usando easy_install/pip/distribute por meio do Índice de Pacotes Python ou baixe-o diretamente do site de download do New Relic.

Novo recurso

• Adiciona suporte para aplicativos de Azure Function

  • Adiciona suporte para aplicativos de Azure Function para tipos HTTPTrigger.

Correções de bugs

• Adiciona arquivos pb2 para habilitar o suporte ao protobuf v6

  • Anteriormente, vários pacotes do Google não eram compatíveis com o New Relic devido à falta de suporte ao protobuf v6. Isso 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 ao Model Context Protocol (MCP) e corrige a lógica de importação para importlib.metadata e pkg_resources.

Instale o agente usando easy_install/pip/distribute por meio do Índice de Pacotes Python ou baixe-o diretamente do site de download do New Relic.

Novo recurso

• Adicionar suporte para o Model Context Protocol (MCP)

  • Adiciona suporte para chamadas MCP em mcp e fastmcp. O agente agora instrumentará automaticamente as seguintes primitivas principais do MCP:

    • Ferramentas (via call_tool)
    • Recursos (via read_resource)
    • Prompt (via get_prompt)

Correções de bugs

• Corrigir lógica de importação para importlib.metadata e pkg_resources

  • Atualiza a lógica em torno da importação de importlib.metadata para também tentar usar o backport importlib_metadata antes de retornar para pkg_resources.*. Isso também remove o uso de condicionais sys.version e corrige problemas em que o Python 3.9 só podia usar pkg_resources apesar de ter importlib.metadata disponível.

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.