Java agent release notesRSS

Novos recursos e melhorias

• Adicionar a configuração log_level_denylist ao yaml padrão 2830

• Módulo JMX do Solr 9 2821

• Nova estratégia centralizada de contagem de tokens para capturar contagens de tokens de respostas de LLM. 2837

• Suporte para capturar operações em lote JDBC; especificamente os métodos addBatch() e executeBatch(). 2840

• Módulo de instrumentação XML RPC para substituir point cut legado 2841

• Adicionar uma nova configuração específica do JFR jfr.use_display_name. Se definido como true, o agente definirá o nome do host JFR para o valor na configuração process_host.display_name. O padrão é falso para preservar o comportamento antigo.

Se jfr.use_display_name for true, mas a configuração display_name estiver vazia, o JfrService reverterá para o comportamento antigo para o nome do host.

common: &default_settings
  jfr:
    use_display_name: true

2.847

• Remover a criação desnecessária de segmento no módulo java.xmlrpc 2853

• Atualizar o módulo aws-bedrock-runtime-2.20 com uma nova estratégia de contagem de token para cada um dos modelos. 2845

• Novo algoritmo de ofuscação de chave de licença 2864

• Suporte para Micronaut Http Clients versões 3.5.0+ 2834

• Suporte para Apache Camel 3.9.0 e superior 2896 2901

• Suporte para Kafka Clients 4.0.0 e superior 2896

• Atualização da dependência interna Log4j Core de 2.17.1 para 2.25.4 2833

• Suporte ao AWS DAX a partir da versão 2.0.0 até a mais recente 2873

• Adicionar instrumentação para clientes de completion e embedding do Spring AI para versões 1.0.0 e superiores. Isso adiciona novos módulos de instrumentação:

spring-ai-client-chat-1.0.0
spring-ai-model-1.0.0

2.842

• Core Tracing - Descartar SpanEvents e reassociar SpanLinks descartados 2881

• Substituições de pointcut

  • Remova SpringDispatcherPointCut e SpringExceptionHandlerPointCut e, em vez disso, mova a funcionalidade para nossos módulos de instrumentação do Spring.
  • Substituir HandlerInterceptorPointCut 2871 2886

• Suporte ao BlockingHttpClient do Micronaut 2860

• Adicionar suporte para o Model Context Protocol de modelo de IA 1.0.0 até a versão mais recente. 2880

Correções

• Corrige a instrumentação de coroutines. As correções incluem:

  • Melhor rastreamento do comportamento assíncrono por ter instrumentado lacunas que foram encontradas onde a execução pode saltar para outra thread.
  • Melhor nomenclatura de Coroutines e Continuações. A nomenclatura existente era muito genérica. A nova nomenclatura identifica de acordo com se é iniciado via runBlocking, async, withContext ou lançamento.
  • Removidos alguns métodos utilitários que não eram mais utilizados 2802

• Corrige o número excessivo de tokens assíncronos não expirados quando o Micronaut é instrumentado. 2792

• Resolução do IllegalAccessError do Mule 4.9 2859

• Corrigir um registro incorreto das métricas Instrumentadas e Mantidas para o Core Tracing, pois elas estavam sendo originalmente registradas como uma métrica de tempo. 2881

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

• Adiciona suporte ao Java 26 2734
• Adiciona o modo Serverless para o monitoramento do AWS Lambda com o agente Java 2609 2615 2625 2633 2640 2641 2647 2673 2716 2721 2735 2723 2740 2769 2782 2794 2797 2796 2806
• Adiciona nova configuração application_logging.forwarding.log_level_denylist 2764
• Implementa URIs de ingestão de evento/métrica com reconhecimento de região 2749 2790
• Adiciona suporte para associar logs à entidade correspondente quando enable_auto_app_naming é true 2627
• Adicionar instrumentação de opentelemetry-sdk-extension-autoconfigure-1.59.0 para OpenTelemetry 1.59.0+ 2786
• Adiciona suporte para associar o amostrador adaptativo à entidade correspondente quando enable_auto_app_naming é true 2805
• Adiciona métricas de suportabilidade para cada entidade criada quando enable_auto_app_naming é true 2808
• Implementa a configuração do proxy de desvio de metadados da nuvem 2791
• Adiciona suporte para várias versões do Caffeine no agente 2807
• Adiciona suporte para planos de execução que utilizam matrizes SQL 2815
• Adiciona 'Queue' genérico como um tipo de transporte 2820
• Adiciona suporte para chamadas de cliente Http do Reactor Netty 2817

Correções

• Corrige um caso limite em que cargas malformadas causavam um NPE ao acessar o campo sampled na carga do NR 2762
• Expira tokens quando uma assinatura reativa é cancelada 2798
• Adiciona lógica para remover manualmente quaisquer threads mortas do cache TheadTracker para evitar um vazamento de memória 2811
• Resolve um deadlock entre a thread de coleta e a thread de encerramento da JVM 2539

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

• O Agente Híbrido Java: oferecendo uma experiência do "melhor dos dois mundos" ao combinar a visibilidade profunda da New Relic com a compatibilidade com a API OpenTelemetry. Esta versão inclui suporte abrangente para as APIs de Tracing, Métricas e Logs do OpenTelemetry, bem como instrumentação de bibliotecas independentes e frameworks nativos. Principais melhorias, como Span Links e Events on Spans, estão agora disponíveis, garantindo interoperabilidade perfeita em ambientes de modo misto.
  • Suporte à API OpenTelemetry do Agente Híbrido por @jasonjkeller em 2711
• Melhorias em ignorar corrotinas por @dhilpipre em 2726
• Adicionar ação de metadados do agente - @mvicknr em 2732 2745

Correções

• Correção da propagação de rastreamento quebrada com cabeçalhos w3c por @jasonjkeller em 2299
• Correção da configuração de preferência multihost @jtduffy em 2720
• Corrigido problema onde suspend ignores não estava sendo lido, por @dhilpipre em 2663

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

• Adicionar configuração para excluir jars temporários de agente obsoletos na inicialização por @jtduffy em 2676
• Adicionar a opção "inclusão" para complementar a configuração de exclusão para instrumentar seletivamente aplicativos @jtduffy em 2638
  • Para usar este recurso, defina a variável de ambiente NEW_RELIC_STARTUP_JAVA_ARTIFACT_INCLUDES ou a propriedade do sistema newrelic.config.startup_java_artifact_includes. Especifique os artefatos que devem ser instrumentados como uma lista separada por vírgulas.

Correções

• Resolva IllegalAccessError movendo a classe wrapper de S3AsyncClient_Instrumentation por @jtduffy em 2503
• Corrigir versão de instrumentação rotulada incorretamente em eventos de log em logback-classic-1.5.20 por @jasonjkeller em 2594
• Mensagem de log corrigida para valor máximo de atributo por @jeffalder em 2680
• Prioridades do amostrador de Taxa de Rastreamento corrigidas por @jtduffy em 2583

Remoções

• Remove os módulos jdbc-inet-* obsoletos por @obenkenobi em 2572
• Remove a biblioteca obsoleta java.completable-future-jdk8. instrumentação por @obenkonobi em 2562
• Remove a instrumentação de encapsulamento aws por @obenkenobi em 2567
• Remove o módulo jdbc-sybase-6 por @obenkenobi em 2614
• Remove a instrumentação play 2.3 por @obenkenobi em 2568
• Remove thrift-0.8 obsoleto módulo por @obenkenobi em 2569
• Remove os módulos solr 4.0 e 5.0 obsoletos por @obenkenobi em 2570
• Remove o módulo obsoleto grails-1.3 por @obenkonobi em 2573
• Remove o módulo obsoleto hibernate-3.3 por @obenkenobi em 2574
• Remove a API de injeção de rodapé obsoleta por @sharvath-newrelic em 2620
• Remove pointcuts Struts 1 obsoletos por @obenkenobi em 2561
• Remove o módulo obsoleto glassfish-3 por @sharvath-newrelic em 2575
• Remove os módulos rabbit-amqp obsoletos 2.5.0, 2.4.1, 1.7.2 por @obenkenobi em 2571
• Remove a função de marcador de implantação por @jtduffy em 2589

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