New Relic Documentation

Novos recursos e melhorias

Suporte ao Java 19 1022
Suporte ao Play 2.8.16+ 981
Suporte ao ojdbc8 v21.1.0.0+ 1042
Suporte a JVMs Semeru/OpenJ9 993
Suporte ao encaminhamento de logs para java.util.logging (JUL) 1049
Suporte ao encaminhamento de dados de contexto de log 866
O agente agora pode encaminhar dados no Mapped Diagnostic Context (MDC, logback/slf4j) e ThreadContext (log4j2) como atributos ao encaminhar registros de log. Quando o recurso estiver habilitado, esses atributos serão adicionados aos registros de log com um prefixo context.. Para obter detalhes sobre como habilitar este recurso, consulte a documentação do context_data.
Aumento do limite de eventos personalizados 1036
Esta versão aumenta o limite padrão de eventos personalizados de 10.000 eventos por minuto para 30.000 eventos por minuto. No cenário em que os eventos personalizados estavam sendo limitados, essa alteração permitirá que mais eventos personalizados sejam enviados para a New Relic. Há também um novo limite máximo configurável de 100.000 eventos por minuto. Para alterar os limites, consulte a documentação para max_samples_stored. Para saber mais sobre a mudança e como determinar se eventos personalizados estão sendo descartados, consulte nossa postagem no Explorers Hub.
Métricas em nível de código ativadas por padrão 1037
A funcionalidade de métricas de nível de código introduzida com o agente 7.10 agora está habilitada por padrão. Este recurso causará um aumento no consumo de dados. A quantidade depende da aplicação. Para desativar as métricas de nível de código, consulte as instruções em nossa documentação de métricas de nível de código.

Correções

Evita que uma exceção seja lançada na instrumentação do Jedis 1011
Melhoria nas transações Http4s 1006
Correção da API noticeError que não verificava se os erros eram esperados 1014
Adiciona comando para consultas do Lettuce a clusters 1031
Correção de exceção ao gerar o jar do agente a partir de um repositório limpo 1048
Melhor tratamento de erros para métricas em nível de código 1021 1051
Correção de spans do HttpUrlConnection que não encerravam em exceção 1053

Aviso de descontinuação

Os seguintes módulos de instrumentação estão sendo descontinuados para remoção:

cassandra-datastax-2.1.2
httpclient-3.0
jdbc-embedded-derby-10.10.1.1
jetty-7
jetty-7.6
jetty-9
jetty-9.0.4
jetty-9.1
mongodb-2.12
mongodb-2.14
mongodb-3.0
okhttp-3.0.0
okhttp-3.4.0
okhttp-3.5.0

Os atributos de transação/span httpResponseCode, response.status e response.statusMessage estão descontinuados e serão removidos em uma versão futura. Estes foram substituídos por http.statusCode e http.statusText.

Declaração de apoio

A New Relic recomenda que você atualize o agente regularmente para garantir que obtenha os recursos e benefícios de desempenho mais recentes. Além disso, versões mais antigas não serão mais suportadas quando atingirem o fim da vida útil.

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:

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.
Baixe o agente.
Descompacte o novo arquivo de download do agente e copie newrelic-api.jar e newrelic.jar no diretório raiz original do agente Java.
Compare seu newrelic.yml antigo com o newrelic.yml recém-baixado do zip e atualize o arquivo, se necessário.
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.
>       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 na versão 7.11.0 do agente Java. Se você estiver migrando para a 7.11.0 ou superior, você deve adicionar estas novas linhas ao seu newrelic.yml original.