Java agent release notesRSS

New features and improvements

• Add log_level_denylist config to default yaml 2830

• Solr 9 JMX module 2821

• New centralized token counting strategy for capturing token counts from LLM Responses. 2837

• Support for capturing JDBC batch operations; specifically the addBatch() and executeBatch() methods. 2840

• XML RPC instrumentation module to replace legacy point cut 2841

• Add a new JFR specific config jfr.use_display_name. If set to true, the agent will set the JFR host name to the value in the process_host.display_name configuration. The default is false to preserve old behavior.

If jfr.use_display_name is true but the display_name config is empty, the JfrService will fallback to the old behavior for the host name.

common: &default_settings
  jfr:
    use_display_name: true

2847

• Remove unneeded segment creation in java.xmlrpc module 2853

• Update aws-bedrock-runtime-2.20 Module with a new token counting strategy for each of the models. 2845

• New license key obfuscation algorithm 2864

• Support for Micronaut Http Clients versions 3.5.0+ 2834

• Support for Apache Camel 3.9.0 and up 2896 2901

• Support for Kafka Clients 4.0.0 and up 2896

• Internal dependency Log4j Core Upgrade from 2.17.1 to 2.25.4 2833

• AWS DAX Support starting from 2.0.0 to latest 2873

• Add instrumentation for Spring AI completion and embedding clients for versions 1.0.0 and up. This adds new instrumentation modules:

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

2842

• Core Tracing - Drop SpanEvents and Re-Parent dropped SpanLinks 2881

• Pointcut replacements

  • Remove SpringDispatcherPointCut and SpringExceptionHandlerPointCut and instead move the functionality into our Spring instrumentation modules.
  • Replace HandlerInterceptorPointCut 28712886

• Support Micronaut’s BlockingHttpClient 2860

• Add support for AI Model Context Protocol 1.0.0 to latest. 2880

Fixes

• Fix coroutines instrumentation. Fixes include:

  • Better tracking of asynchronous behavior by instrumenting gaps that were found where execution can jump to another thread.
  • Better naming on Coroutines and Continuations. Existing naming was too generic. New naming identifies according to whether it is started via runBlocking, async, withContext or launch.
  • Removed some utility methods that were no longer used 2802

• Fixes excessive number of unexpired async tokens when instrumenting Micronaut. 2792

• Resolution of Mule 4.9 IllegalAccessError 2859

• Fix a mis-recording of the Instrumented and Kept metrics for Core Tracing, as they were originally being recorded as a time metric. 2881

Update to latest version

To identify which version of the Java agent you're currently using, run java -jar newrelic.jar -v. Your Java agent version will be printed to your console.

Then, to update to the latest Java agent version:

1. Back up the entire Java agent root directory to another location. Rename that directory to NewRelic_Agent#.#.#, where #.#.# is the agent version number.
2. Download the agent..
3. Unzip the new agent download file, then copy newrelic-api.jar and newrelic.jar into the original Java agent root directory.
4. Compare your old newrelic.yml with the newly downloaded newrelic.yml from the zip, and update the file if needed.
5. Restart your Java dispatcher.

If you experience issues after the Java agent update, restore from the backed-up New Relic agent directory.

Update agent config differences

We add new settings to newrelic.yml as we release new versions of the agent. You can use diff or another diffing utility to see what's changed, and add the new config settings to your old file. Make sure not to overwrite any customizations you've made to the file, such as your license key, app name, or changes to default settings.

For example, if you diff the default newrelic.yml files for Java agent versions 7.10.0 and 7.11.0, the results printed to the console will be like:

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

In this example, these lines were added to the default newrelic.yml in Java agent version 7.11.0. If you're moving to 7.11.0 or higher, you should add these new lines to your original newrelic.yml.

Support statement:

• New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Nuevas características y mejoras

• Agrega soporte para Java 26 2734
• Agrega el modo Serverless para el monitoreo de AWS Lambda con el agente de Java 2609 2615 2625 2633 2640 2641 2647 2673 2716 2721 2735 2723 2740 2769 2782 2794 2797 2796 2806
• Agrega nueva configuración de application_logging.forwarding.log_level_denylist 2764
• Implementa URI de ingesta de evento/métrica con reconocimiento de región 2749 2790
• Agrega soporte para asociar logs a la entidad correspondiente cuando enable_auto_app_naming es true 2627
• Agrega instrumentación de opentelemetry-sdk-extension-autoconfigure-1.59.0 para OpenTelemetry 1.59.0+ 2786
• Agrega soporte para asociar el muestreador adaptativo a la entidad correspondiente cuando enable_auto_app_naming es true 2805
• Agrega métrica de soportabilidad para cada entidad creada cuando enable_auto_app_naming es true 2808
• Implementa la configuración del proxy de omisión de metadatos de la nube 2791
• Agrega soporte para múltiples versiones de Caffeine en el agente 2807
• Agrega soporte para planes de ejecución que utilizan matrices de SQL 2815
• Agrega 'Queue' genérica como tipo de transporte 2820
• Agrega soporte para llamadas de cliente HTTP de Reactor Netty 2817

Correcciones

• Corrige un caso extremo donde la carga mal formada provocaba un NPE al acceder al campo sampled en la carga de NR 2762
• Expira los token cuando se cancela una suscripción reactiva 2798
• Agrega lógica para desalojar manualmente cualquier hilo muerto de la caché TheadTracker para evitar una fuga de memoria 2811
• Resuelve un interbloqueo entre el hilo de recolección y el hilo de apagado de la JVM 2539

Actualizar a la última versión

Para identificar qué versión del agente de Java estás usando actualmente, ejecuta java -jar newrelic.jar -v. Su versión de agente de Java se imprimirá en su consola.

Luego, para actualizar a la última versión del agente de Java:

1. Haga una copia de seguridad de todo el directorio raíz del agente de Java en otra ubicación. Cambie el nombre de ese directorio a NewRelic_Agent#.#.#, donde #.#.# es el número de versión del agente.
2. Descargar el agente..
3. Descomprima el archivo de descarga del nuevo agente y luego copie newrelic-api.jar y newrelic.jar en el directorio raíz del agente de Java original.
4. Compare su newrelic.yml antiguo con el newrelic.yml recién descargado del zip y actualice el archivo si es necesario.
5. Reinicie su despachador de Java.

Si tiene problemas después de la actualización del agente de Java, restaure desde el directorio del agente New Relic respaldado.

Actualizar diferencias de configuración del agente

Agregamos nuevas configuraciones a newrelic.yml a medida que lanzamos nuevas versiones del agente. Puede usar diff u otra utilidad de diferenciación para ver qué ha cambiado y agregar la nueva configuración a su archivo anterior. Asegúrese de no sobrescribir ninguna personalización que haya realizado en el archivo, como su clave de licencia, el nombre de la aplicación o los cambios en la configuración predeterminada.

Por ejemplo, si diff los archivos newrelic.yml predeterminados para las versiones 7.10.0 y 7.11.0 del agente de Java , los resultados impresos en la consola serán 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
...

En este ejemplo, estas líneas se agregaron al valor predeterminado newrelic.yml en el agente de Java versión 7.11.0. Si está migrando a la versión 7.11.0 o superior, debe agregar estas nuevas líneas a su newrelic.yml original.

Declaración de apoyo:

• New Relic recomienda que actualices el agente periódicamente para garantizar que obtengas las últimas características y beneficios de rendimiento. Además, las versiones anteriores ya no recibirán soporte cuando lleguen al final de su vida útil.

Nuevas características y mejoras

• El Agente híbrido de Java: ofrece una experiencia de "lo mejor de ambos mundos" al combinar la visibilidad profunda de New Relic con la compatibilidad con la API de OpenTelemetry. Esta versión incluye soporte integral para las API de Tracing, Metrics y Logs de OpenTelemetry, así como instrumentación de bibliotecas independientes y frameworks nativos. Mejoras clave como Span Links y Events on Spans ya están disponibles, garantizando una interoperabilidad fluida en entornos de modo mixto.
  • Soporte de la API de OpenTelemetry del agente híbrido por @jasonjkeller en 2711
• Mejoras en la omisión de corrutinas por @dhilpipre en 2726
• Agregar acción de metadatos del agente - @mvicknr en 2732 2745

Correcciones

• Se corrigió la propagación de trazas rota con encabezados w3c por @jasonjkeller en 2299
• Se corrigió la configuración de preferencia multihost @jtduffy en 2720
• Se solucionó un problema donde suspend ignores no se leía, por @dhilpipre en 2663

Actualizar a la última versión

Para identificar qué versión del agente de Java estás usando actualmente, ejecuta java -jar newrelic.jar -v. Su versión de agente de Java se imprimirá en su consola.

Luego, para actualizar a la última versión del agente de Java:

1. Haga una copia de seguridad de todo el directorio raíz del agente de Java en otra ubicación. Cambie el nombre de ese directorio a NewRelic_Agent#.#.#, donde #.#.# es el número de versión del agente.
2. Descargar el agente..
3. Descomprima el archivo de descarga del nuevo agente y luego copie newrelic-api.jar y newrelic.jar en el directorio raíz del agente de Java original.
4. Compare su newrelic.yml antiguo con el newrelic.yml recién descargado del zip y actualice el archivo si es necesario.
5. Reinicie su despachador de Java.

Si tiene problemas después de la actualización del agente de Java, restaure desde el directorio del agente New Relic respaldado.

Actualizar diferencias de configuración del agente

Agregamos nuevas configuraciones a newrelic.yml a medida que lanzamos nuevas versiones del agente. Puede usar diff u otra utilidad de diferenciación para ver qué ha cambiado y agregar la nueva configuración a su archivo anterior. Asegúrese de no sobrescribir ninguna personalización que haya realizado en el archivo, como su clave de licencia, el nombre de la aplicación o los cambios en la configuración predeterminada.

Por ejemplo, si diff los archivos newrelic.yml predeterminados para las versiones 7.10.0 y 7.11.0 del agente de Java , los resultados impresos en la consola serán 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
...

En este ejemplo, estas líneas se agregaron al valor predeterminado newrelic.yml en el agente de Java versión 7.11.0. Si está migrando a la versión 7.11.0 o superior, debe agregar estas nuevas líneas a su newrelic.yml original.

Declaración de apoyo:

• New Relic recomienda que actualices el agente periódicamente para garantizar que obtengas las últimas características y beneficios de rendimiento. Además, las versiones anteriores ya no recibirán soporte cuando lleguen al final de su vida útil.

Nuevas características y mejoras

• Agregar configuración para eliminar los archivos jar temporales del agente obsoletos al inicio por @jtduffy en 2676
• Añada la opción de "inclusión" para complementar la configuración de exclusión para instrumentar selectivamente aplicaciones @jtduffy en 2638
  • Para usar esta función, configure la variable de entorno NEW_RELIC_STARTUP_JAVA_ARTIFACT_INCLUDES o la propiedad del sistema newrelic.config.startup_java_artifact_includes. Especifique los artefactos que deben instrumentarse como una lista separada por comas.

Correcciones

• Resuelve IllegalAccessError moviendo la clase wrapper fuera de S3AsyncClient_Instrumentation por @jtduffy en 2503
• Corregir la versión de instrumentación mal etiquetada en los eventos de log en logback-classic-1.5.20 por @jasonjkeller en 2594
• Mensaje de logging fijo para el valor máximo del atributo por @jeffalder en 2680
• Se corrigieron las prioridades del muestreador de Trace Ratio por @jtduffy en 2583

Eliminaciones

• Elimina los módulos jdbc-inet-* obsoletos por @obenkenobi en 2572
• Elimina el obsoleto java.completable-future-jdk8 instrumentación de @obenkenobi en 2562
• Elimina la instrumentación de ajuste de AWS por @obenkenobi en 2567
• Elimina el módulo jdbc-sybase-6 por @obenkenobi en 2614
• Elimina la instrumentación de play 2.3 por @obenkenobi en 2568
• Elimina la versión obsoleta thrift-0.8 módulo de @obenkenobi en 2569
• Elimina los módulos solr 4.0 y 5.0 obsoletos por @obenkenobi en 2570
• Elimina el módulo obsoleto grails-1.3 por @obenkenobi en 2573
• Elimina el módulo obsoleto hibernate-3.3 por @obenkenobi en 2574
• Elimina la API de inyección de pie de página obsoleta por @sharvath-newrelic en 2620
• Elimina los pointcuts de Struts 1 obsoletos por @obenkenobi en 2561
• Elimina el módulo glassfish-3 obsoleto por @sharvath-newrelic en 2575
• Elimina los módulos obsoletos rabbit-amqp 2.5.0, 2.4.1, 1.7.2 por @obenkenobi en 2571
• Elimina la función de marcador de implementación por @jtduffy en 2589

Actualizar a la última versión

Para identificar qué versión del agente de Java estás usando actualmente, ejecuta java -jar newrelic.jar -v. Su versión de agente de Java se imprimirá en su consola.

Luego, para actualizar a la última versión del agente de Java:

1. Haga una copia de seguridad de todo el directorio raíz del agente de Java en otra ubicación. Cambie el nombre de ese directorio a NewRelic_Agent#.#.#, donde #.#.# es el número de versión del agente.
2. Descargar el agente..
3. Descomprima el archivo de descarga del nuevo agente y luego copie newrelic-api.jar y newrelic.jar en el directorio raíz del agente de Java original.
4. Compare su newrelic.yml antiguo con el newrelic.yml recién descargado del zip y actualice el archivo si es necesario.
5. Reinicie su despachador de Java.

Si tiene problemas después de la actualización del agente de Java, restaure desde el directorio del agente New Relic respaldado.

Actualizar diferencias de configuración del agente

Agregamos nuevas configuraciones a newrelic.yml a medida que lanzamos nuevas versiones del agente. Puede usar diff u otra utilidad de diferenciación para ver qué ha cambiado y agregar la nueva configuración a su archivo anterior. Asegúrese de no sobrescribir ninguna personalización que haya realizado en el archivo, como su clave de licencia, el nombre de la aplicación o los cambios en la configuración predeterminada.

Por ejemplo, si diff los archivos newrelic.yml predeterminados para las versiones 7.10.0 y 7.11.0 del agente de Java , los resultados impresos en la consola serán 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
...

En este ejemplo, estas líneas se agregaron al valor predeterminado newrelic.yml en el agente de Java versión 7.11.0. Si está migrando a la versión 7.11.0 o superior, debe agregar estas nuevas líneas a su newrelic.yml original.

Declaración de apoyo:

• New Relic recomienda que actualices el agente periódicamente para garantizar que obtengas las últimas características y beneficios de rendimiento. Además, las versiones anteriores ya no recibirán soporte cuando lleguen al final de su vida útil.

Correcciones

• Corrige el error de la corrutina Kotlin sobre la implementación de terceros de CancellableContinuation

Desusos

• 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

Actualizar a la última versión

Para identificar qué versión del agente de Java estás usando actualmente, ejecuta java -jar newrelic.jar -v. Su versión de agente de Java se imprimirá en su consola.

Luego, para actualizar a la última versión del agente de Java:

1. Haga una copia de seguridad de todo el directorio raíz del agente de Java en otra ubicación. Cambie el nombre de ese directorio a NewRelic_Agent#.#.#, donde #.#.# es el número de versión del agente.
2. Descargue el agente.
3. Descomprima el archivo de descarga del nuevo agente y luego copie newrelic-api.jar y newrelic.jar en el directorio raíz del agente de Java original.
4. Compare su newrelic.yml antiguo con el newrelic.yml recién descargado del zip y actualice el archivo si es necesario.
5. Reinicie su despachador de Java.

Si tiene problemas después de la actualización del agente de Java, restaure desde el directorio del agente New Relic respaldado.

Actualizar diferencias de configuración del agente

Agregamos nuevas configuraciones a newrelic.yml a medida que lanzamos nuevas versiones del agente. Puede usar diff u otra utilidad de diferenciación para ver qué ha cambiado y agregar la nueva configuración a su archivo anterior. Asegúrese de no sobrescribir ninguna personalización que haya realizado en el archivo, como su clave de licencia, el nombre de la aplicación o los cambios en la configuración predeterminada.

Por ejemplo, si diff los archivos newrelic.yml predeterminados para las versiones 7.10.0 y 7.11.0 del agente de Java , los resultados impresos en la consola serán 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
...

En este ejemplo, estas líneas se agregaron al valor predeterminado newrelic.yml en el agente de Java versión 7.11.0. Si está migrando a la versión 7.11.0 o superior, debe agregar estas nuevas líneas a su newrelic.yml original.

Declaración de apoyo:

• New Relic recomienda que actualices el agente periódicamente para garantizar que obtengas las últimas características y beneficios de rendimiento. Además, las versiones anteriores ya no recibirán soporte cuando lleguen al final de su vida útil.