Novos recursos e melhorias

• Adicionado suporte ao Webflux 6 1181

• Adicionado suporte ao Spring JMS 6 1088

• Adicionado suporte para Mongodb Reactive Streams 1164

• Adicionado suporte ao Kafka Streams 1170

  O suporte ao Kafka Streams vem em dois formatos: métricas e spans. As métricas são habilitadas por padrão, enquanto os spans são desabilitados por padrão. Para habilitar spans, adicione o seguinte à sua configuração do newrelic.yml na seção common:

common:
  class_transformer:
    kafka-streams-spans:
      enabled: true

• Impressão digital de erro - forneça seus próprios nomes de grupo do Errors inbox 1195

  Suas ocorrências de erro estão mal agrupadas? Defina seu próprio fingerprint de erro via uma função de retorno de chamada. Foi adicionado um novo método de API pública que aceitará um proc definido pelo usuário. O proc será invocado para cada erro notado e, sempre que retornar uma string, essa string será usada como o nome do grupo de erros para o erro e terá precedência sobre qualquer agrupamento no lado do servidor que ocorra com o Errors Inbox do New Relic. Isso oferece aos usuários um controle muito maior sobre o agrupamento de seus erros. Para mais informações, consulte nossas páginas API: Agrupamento de erros e APM: aba Agrupar erros.

• Rastreamento de usuário - associar erros a um ID de usuário 1188

  Agora você pode ver o número de usuários impactados por um grupo de erros. Identifique o usuário final com um novo método de API pública que aceitará uma representação de string de um ID de usuário e associará esse ID de usuário à transação atual. Transações e erros terão então um novo atributo de agente enduser.id associado a eles. Isso permitirá que os usuários do agente adicionem tags a transações e erros como pertencentes a determinados IDs de usuário, para dar suporte a recursos aprimorados de filtragem e alerta. Para mais informações, consulte a documentação [Newrelic.setUserId ](https://newrelic.github.io/java-agent-api/javadoc/com/newrelic/api/agent/NewRelic.html#setUserName(java.lang.String) e a página Rastrear usuários impactados com o Errors Inbox.

• Invocar token.link() fora de uma transação instrumentará esse método para iniciar uma transação assíncrona 1140

• A instrumentação de clientes Kafka possui novas métricas para listar os nós: MessageBroker/Kafka/Nodes/<node> 1130

Correções

• Correção do ClassCircularityError quando o agente anexa 1137
• Correção de NullPointerException lançada ao chamar addCustomAttributes 1115
• Certifique-se de que TokenAndRefCount.token nunca seja nulo 1149
• Uso de um cache baseado em tempo para armazenar dados de conexão de banco de dados para evitar um vazamento de memória ao instrumentar o cliente MySQL com replicação 1114
• Reduziu o número de threads usadas na instrumentação do HttpUrlConnection 1145
• Correção de um problema quando HttpUrlConnection é usado com o rastreamento entre aplicações legado 1142
• Melhoria de desempenho no RequestWrapper do Netty 1163
• Encerrar o agente graciosamente se encontrar problemas na inicialização 1136
• Corrigir as anotações WeavedMethod e InstrumentedMethod quando aplicadas a construtores. 1153
• Melhorias de desempenho ao usar o Tomcat 1131
• Corrigido um bug que fazia com que o agente não reportasse algumas exceções 1176
• DockerData atualizado para aumentar o número de IDs de contêiner detectados 1178
• Reduz o número de threads utilizados na instrumentação de clientes Kafka 1056
• Alterações gramaticais [1175](https://github.com/newrelic/newrelic-java-agent/pull/1175 e [1190]https://github.com/newrelic/newrelic-java-agent/pull/1190)

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

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.