Novos recursos e melhorias

• Suporte para CRaC 2250

• Suporte para JDK24 2284

• Opções de amostragem adicionadas quando existe um traceparent de entrada 2279

  • Essas opções definem como o agente deve lidar com a amostragem de intervalos, dependendo das decisões de amostragem que foram tomadas para seu intervalo por uma entidade upstream. As opções de configuração remote_parent_sampled e remote_parent_not_sampled especificam o que fazer caso o intervalo pai tenha sido amostrado ou não amostrado, respectivamente. Consulte a documentação para obter detalhes completos da configuração.

• Suporte para Undertow como um módulo autônomo 2269

  • Esta instrumentação é desabilitada por padrão para evitar conflitos com a instrumentação Wildfly existente. Para habilitar essa instrumentação para aplicativos de servidor Undertow autônomos, use a configuração:

  class_transformer:
     com.newrelic.instrumentation.undertow-server-1.1.0:
       enabled: true

  Copiar

• Suporte para o cliente Couchbase 2203

  • Se o Módulo Experimental do Cliente Couchbase estiver em uso, remova-o do seu diretório de extensões antes de atualizar para esta versão do agente Java.

Correções

• Corrigir transações netty 'Desconhecidas' 2274

  • Esta correção move alterações anteriores da instrumentação do netty para trás de um sinalizador de recurso, o que fornece visibilidade adicional em alguns casos envolvendo transações HTTP2. Para reativar essa granularidade (ao possível custo de ver transações "Desconhecidas"), use a configuração:

  netty:
      http2:
        frame_read_listener:
          start_transaction: true

  Copiar

• Refatore a busca de ID do Docker da AWS para usar o tempo limite de 5s 2275

• sinalizador de recurso para aplicar a correção Kotlin ArrayIndexOutOfBoundsException a todos os métodos 2307

  • Esta correção corrige erros que podem ser vistos ao executar o agente Java em um ambiente onde funções de suspensão do Kotlin são usadas. Para usar esta correção, defina a propriedade do sistema -Dnewrelic.config.class_transformer.clear_return_stacks=true

• Impedir bloqueio de cache para análise de instruções longas de BD 2294

• Adicionar configuração para especificar se java.sql é carregado pelo carregador de classes de plataforma 2267

Depreciações

Os seguintes módulos de instrumentação estão obsoletos e serão removidos na próxima versão principal:

• aws-wrap-0.7.0
• java.completable-future-jdk8
• play-2.3
• netty-3.4
• Struts v1

Atualizar para a versão mais recente

Para identificar qual versão do agente Java você está usando atualmente, execute java -jar newrelic.jar -v. A versão do seu agente Java será impressa em seu console.

Em seguida, para atualizar para a versão mais recente do agente Java:

1. Faça backup de todo o diretório raiz do agente Java em outro local. Renomeie esse diretório para NewRelic_Agent#.#.#, onde #.#.# é o número da versão do agente.
2. Baixe o agente..
3. Descompacte o novo arquivo de download do agente e copie newrelic-api.jar e newrelic.jar no diretório raiz original do agente Java.
4. Compare seu newrelic.yml antigo com o newrelic.yml recém-baixado do zip e atualize o arquivo, se necessário.
5. Reinicie seu despachante Java.

Se você tiver problemas após a atualização do agente Java, restaure a partir do diretório do agente New Relic do qual foi feito backup.

Atualizar diferenças de configuração do agente

Adicionamos novas configurações a newrelic.yml à medida que lançamos novas versões do agente. Você pode usar diff ou outro utilitário de comparação para ver o que mudou e adicionar as novas configurações ao seu arquivo antigo. Certifique-se de não substituir nenhuma personalização feita no arquivo, como chave de licença, nome do aplicativo ou alterações nas configurações padrão.

Por exemplo, se você diff os arquivos newrelic.yml padrão para as versões 7.10.0 e 7.11.0 do agente Java, os resultados impressos no console serão como:

➜ diff newrelic_7.10.0.yml newrelic_7.11.0.yml
...
107a108,119
>       # Whether the log events should include context from loggers with support for that.
>       include_context_data:
>
>         # When true, application logs will contain context data.
>         enabled: false
>
>         # A comma separated list of attribute keys whose values should be sent to New Relic.
>         #include:
>
>         # A comma separated list of attribute keys whose values should not be sent to New Relic.
>         #exclude:
>
125a138
>
128c141
<     enabled: false
---
>     enabled: true
...

Neste exemplo, essas linhas foram adicionadas ao newrelic.yml padrão no agente Java versão 7.11.0. Se você estiver migrando para 7.11.0 ou superior, adicione essas novas linhas ao seu newrelic.yml original.

Declaração de apoio:

• New Relic recomenda que você atualize o agente regularmente para garantir que esteja obtendo os benefícios mais recentes de recursos e desempenho. Além disso, versões mais antigas não terão mais suporte quando chegarem ao fim de sua vida útil.