Java agent release notesRSS

Novos recursos e melhorias

• Adiciona suporte ao Java 25 por @deleonenriqueta em 2512
• Adiciona suporte para Logback-1.5.20 por @jtduffy em 2535
• Introduz uma opção de configuração para desativar a execução das expressões regulares do analisador SQL call e exec por @jtduffy em 2490
• Adiciona suporte para Kotlin Coroutines v1.4+ por @dhilpipere em 2454
• Adiciona suporte para funções de suspensão de Coroutines do Kotlin geradas fora das Coroutines do Kotlin por @dhilpipre em 2456
• Introduz uma configuração de preferências para múltiplos hosts durante a detecção de armazenamento de dados por @jbedell-newrelic em 2508
• Adiciona uma propriedade de sistema para configurar a função de ignorar artefatos por @jtduffy em 2509
• Adiciona uma opção de configuração que permite que as transações do Spring Controller sejam nomeadas usando o nome da classe do controller e o nome do método por @sharvath-newrelic em 2532
• Implementa SamplerConfig, centralizando todas as configurações distributed_tracing.sampler no SamplerConfig por @jasonjkeller em 2529
• Atualizações kafka-clients-spans-0.11.0.0 instrumentação do produtor para usar API distributed tracing modernas com suporte W3C Trace Context por @sharvath-newrelic em 2516

Correções

• Corrige a análise dos nomes das classes de erro por @sharvath-newrelic em 2497
• Corrige um possível problema de memória causado por um rastreamento stack excessivamente grande no logging de erros, por @jtduffy em 2498.
• Esclarecer mensagens de logging para atributo inválido em evento personalizado e logging de eventos por @sharvath-newrelic em 2501

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
• spring-3.0.0
• thrift-0.8
• solr-4.0.0
• solr-5.0.0
• jdbc-inet-merlia
• jdbc-inet-oranxo
• grails-1.3
• rabbit-amqp-1.7.2
• rabbit-amqp-2.4.1
• rabbit-amqp-2.5.0
• rabbit-amqp-2.7.0
• glassfish-3
• hibernate-3.3
• hibernate-3.5
• jdbc-jtds

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.

Novos recursos e melhorias

• Suporte ao MongoDB Reactive Streams 5.2.0 e superior por @obenkenobi em 2465
• Suporte para Jedis 6 por @kanderson250 em 2466

Correções

• CouchBase: Adicionar classe skip para evitar instrumentação dupla por @jtduffy em 2462
• Spring WebClient 5.x: Encapsule apenas cabeçalhos em vez de toda a resposta por @jtduffy em 2464

Depreciações

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

Novos recursos e melhorias

• Atualização para suporte à versão 24 do GraphQL por @jtduffy em 2425
• Adicione alface 6.5 instrumentação por @kanderson250 em 2430
• Aumente a versão commons-lang para 3.18.0 por @jtduffy em 2421
• Adicionar lettuce dbName aos parâmetros do armazenamento de dados, quando disponível, por @kanderson250 em 2423
• Adicione uma variável de ambiente para pular a implementação de certos aplicativos. O nome da variável de ambiente é NEW_RELIC_STARTUP_JAVA_ARTIFACT_SKIPS. O valor disso é uma lista separada por vírgulas de classes principais, arquivos jar executáveis ou ferramentas/aplicativos baseados em Java que o agente NÃO deve instrumentar (por exemplo NEW_RELIC_STARTUP_JAVA_ARTIFACT_SKIPS=keytool,myapp.jar,IgnoreThisClass) por @jtduffy em 2433

Correções

• Corrigir um bug em que mensagens SQS com 8 atributos não são enviadas para a AWS. As mensagens SQS precisam de menos de 8 atributos para passar cabeçalhos distributed trace por @obenkenobi em 2422
• Corte a parte "assinatura" do final do nome do tópico no cliente do Azure Service Bus por @jbedell-newrelic em 2440
• Corrigir configuração AutoConfiguredOpenTelemetrySdk por @jasonjkeller em 2451

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.

Novos recursos e melhorias

• Barramento de Serviço do Azure 7.15.0 instrumentação por @jbedell-newrelic em 2384
• Vinculando metadados para serviços de aplicativo do Azure por @jbedell-newrelic em 2399
• Erros de conexão agora registrados como SEVERE por @jtduffy em 2377
• Registrar e ofuscar chaves inválidas adicionadas como atributo aos logs e eventos por @jtduffy em 2388

Correções

• Realocar a biblioteca de anotações do IntelliJ por @meiao em 2383
• Suporte à configuração sampling_target do lado do servidor por @jtduffy em 2386
• Remover a instrumentação MonoFlatMapMain para corrigir possíveis vazamentos de memória por @deleonenriqueta em 2400

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.