Java agent release notesRSS

New features and improvements

• Adds Java 26 support 2734
• Adds Serverless mode for AWS Lambda monitoring with the Java agent 2609 2615 2625 2633 2640 2641 2647 2673 2716 2721 2735 2723 2740 2769 2782 2794 2797 2796 2806
• Adds new application_logging.forwarding.log_level_denylist config 2764
• Implements region aware event/metric ingest URIs 2749 2790 2790
• Adds support for associating logs to corresponding entity when enable_auto_app_naming is true 2627
• Add opentelemetry-sdk-extension-autoconfigure-1.59.0 instrumentation for OpenTelemetry 1.59.0+ 2786
• Adds support for associating adaptive sampler to corresponding entity when enable_auto_app_naming is true 2805
• Adds supportability metrics for each entity created when enable_auto_app_naming is true 2808
• Implements Cloud Metadata Bypass Proxy config 2791
• Adds support for multiple versions of Caffeine in the agent 2807
• Adds support for explain plans that utilize SQL arrays 2815
• Adds generic 'Queue' as a transport type 2820
• Adds support for Reactor Netty Http client calls 2817

Fixes

• Fixes an edge case where ill-formed payloads caused an NPE when accessing the sampled field on the NR payload 2762
• Expires Tokens when a Reactive Subscription is canceled 2798
• Adds logic to manually evict any dead threads from the TheadTracker cache to prevent a memory leak 2811
• Resolves a deadlock between harvest thread and JVM shutdown thread 2539

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.

Nouvelle fonctionnalité et améliorations

• L'agent Java hybride : offrant une expérience « le meilleur des deux mondes » en combinant la visibilité approfondie de New Relic avec la compatibilité de l'API OpenTelemetry. Cette version inclut une prise en charge complète des API de tracing, de métriques et de logs OpenTelemetry, ainsi que l'instrumentation de bibliothèques autonomes et de frameworks natifs. Des améliorations clés telles que Span Links et Events on Spans sont désormais disponibles, garantissant une interopérabilité transparente dans les environnements en mode mixte.
  • Prise en charge de l'API OpenTelemetry pour l'agent hybride par @jasonjkeller dans 2711
• Améliorations des exclusions de coroutines par @dhilpipre dans 2726
• Ajout de l'action de métadonnées de l'agent - @mvicknr dans 2732 2745

Corrections

• Correction de la propagation de trace défectueuse avec les en-têtes W3C par @jasonjkeller dans 2299
• Correction de la configuration de préférence multihôte @jtduffy dans 2720
• Correction d'un problème où suspend ignores n'était pas lu, par @dhilpipre dans 2663

Mise à jour vers la dernière version

Pour identifier la version de l’agent Java que vous utilisez actuellement, exécutez java -jar newrelic.jar -v. Votre version d'agent Java sera imprimée sur votre console.

Ensuite, pour mettre à jour vers la dernière version de l'agent Java :

1. Sauvegardez l’ intégralité du répertoire racine de l’agent Java vers un autre emplacement. Renommez ce répertoire en NewRelic_Agent#.#.#, où #.#.# est le numéro de version de l'agent.
2. Téléchargez l'agent..
3. Décompressez le nouveau fichier de téléchargement de l'agent, puis copiez newrelic-api.jar et newrelic.jar dans le répertoire racine de l'agent Java d'origine.
4. Comparez votre ancien newrelic.yml avec le newrelic.yml nouvellement téléchargé à partir du zip et mettez à jour le fichier si nécessaire.
5. Redémarrez votre répartiteur Java.

Si vous rencontrez des problèmes après la mise à jour de l'agent Java, effectuez la restauration à partir du répertoire de l'agent New Relic sauvegardé.

Différences de configuration de l'agent de mise à jour

Nous ajoutons de nouveaux paramètres à newrelic.yml à mesure que nous sortons de nouvelles versions de l'agent. Vous pouvez utiliser diff ou un autre utilitaire de comparaison pour voir ce qui a changé et ajouter les nouveaux paramètres de configuration à votre ancien fichier. Assurez-vous de ne pas écraser les personnalisations que vous avez apportées au fichier, telles que votre clé de licence, le nom de l'application ou les modifications apportées aux paramètres par défaut.

Par exemple, si vous diff les fichiers par défaut newrelic.yml pour les versions 7.10.0 et 7.11.0 de l'agent Java, les résultats imprimés sur la console seront comme suit :

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

Dans cet exemple, ces lignes ont été ajoutées à la valeur par défaut newrelic.yml dans la version 7.11.0 de l'agent Java. Si vous passez à la version 7.11.0 ou supérieure, vous devez ajouter ces nouvelles lignes à votre newrelic.yml d'origine.

Déclaration de soutien :

• New Relic vous recommande de mettre à niveau l'agent régulièrement pour vous assurer de bénéficier des dernières fonctionnalités et avantages en termes de performances. De plus, les anciennes sorties ne seront plus prises en charge lorsqu'elles atteindront leur fin de vie.

Nouvelle fonctionnalité et améliorations

• Ajouter la configuration pour supprimer les fichiers jar temporaires de l'agent obsolètes au démarrage par @jtduffy dans 2676
• Ajoutez l'option "inclusion" pour compléter la configuration d'exclusion pour l'instrumentation sélective des applications @jtduffy dans 2638
  • Pour utiliser cette fonctionnalité, définissez la variable d'environnement NEW_RELIC_STARTUP_JAVA_ARTIFACT_INCLUDES ou la propriété système newrelic.config.startup_java_artifact_includes. Spécifiez les artefacts à instrumenter sous forme de liste séparée par des virgules.

Corrections

• Résoudre IllegalAccessError en déplaçant la classe wrapper hors de S3AsyncClient_Instrumentation par @jtduffy dans 2503
• Corrigez la version d'instrumentation mal étiquetée sur les événements de log dans logback-classic-1.5.20 par @jasonjkeller dans 2594
• Message de logging corrigé pour la valeur d'attribut maximale par @jeffalder dans 2680
• Priorités de l'échantillonneur Trace Ratio corrigées par @jtduffy dans 2583

Suppressions

• Supprime les modules jdbc-inet-* obsolètes par @obenkenobi dans 2572
• Supprime java.completable-future-jdk8 obsolète instrumentation par @obenkenobi dans 2562
• Supprime l'instrumentation aws wrap par @obenkenobi dans 2567
• Supprime le module jdbc-sybase-6 par @obenkenobi dans 2614
• Supprime l'instrumentation play 2.3 par @obenkenobi dans 2568
• Supprime le thrift-0.8 obsolète module par @obenkenobi dans 2569
• Supprime les modules solr 4.0 et 5.0 obsolètes par @obenkenobi dans 2570
• Supprime le module grails-1.3 obsolète par @obenkenobi dans 2573
• Supprime le module déprécié hibernate-3.3 par @obenkenobi dans 2574
• Supprime l'API d'injection de pied de page dépréciée par @sharvath-newrelic dans 2620
• Supprime les pointcuts Struts 1 dépréciés par @obenkenobi dans 2561
• Supprime le module glassfish-3 obsolète par @sharvath-newrelic dans 2575
• Supprime les modules rabbit-amqp obsolètes 2.5.0, 2.4.1, 1.7.2 par @obenkenobi dans 2571
• Supprime la fonction de marqueur de déploiement par @jtduffy dans 2589

Mise à jour vers la dernière version

Pour identifier la version de l’agent Java que vous utilisez actuellement, exécutez java -jar newrelic.jar -v. Votre version d'agent Java sera imprimée sur votre console.

Ensuite, pour mettre à jour vers la dernière version de l'agent Java :

1. Sauvegardez l’ intégralité du répertoire racine de l’agent Java vers un autre emplacement. Renommez ce répertoire en NewRelic_Agent#.#.#, où #.#.# est le numéro de version de l'agent.
2. Téléchargez l'agent..
3. Décompressez le nouveau fichier de téléchargement de l'agent, puis copiez newrelic-api.jar et newrelic.jar dans le répertoire racine de l'agent Java d'origine.
4. Comparez votre ancien newrelic.yml avec le newrelic.yml nouvellement téléchargé à partir du zip et mettez à jour le fichier si nécessaire.
5. Redémarrez votre répartiteur Java.

Si vous rencontrez des problèmes après la mise à jour de l'agent Java, effectuez la restauration à partir du répertoire de l'agent New Relic sauvegardé.

Différences de configuration de l'agent de mise à jour

Nous ajoutons de nouveaux paramètres à newrelic.yml à mesure que nous sortons de nouvelles versions de l'agent. Vous pouvez utiliser diff ou un autre utilitaire de comparaison pour voir ce qui a changé et ajouter les nouveaux paramètres de configuration à votre ancien fichier. Assurez-vous de ne pas écraser les personnalisations que vous avez apportées au fichier, telles que votre clé de licence, le nom de l'application ou les modifications apportées aux paramètres par défaut.

Par exemple, si vous diff les fichiers par défaut newrelic.yml pour les versions 7.10.0 et 7.11.0 de l'agent Java, les résultats imprimés sur la console seront comme suit :

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

Dans cet exemple, ces lignes ont été ajoutées à la valeur par défaut newrelic.yml dans la version 7.11.0 de l'agent Java. Si vous passez à la version 7.11.0 ou supérieure, vous devez ajouter ces nouvelles lignes à votre newrelic.yml d'origine.

Déclaration de soutien :

• New Relic vous recommande de mettre à niveau l'agent régulièrement pour vous assurer de bénéficier des dernières fonctionnalités et avantages en termes de performances. De plus, les anciennes sorties ne seront plus prises en charge lorsqu'elles atteindront leur fin de vie.

Corrections

• Corrige l'erreur de coroutine Kotlin concernant l'implémentation tierce de CancellableContinuation

Dépréciations

• 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

Mise à jour vers la dernière version

Pour identifier la version de l’agent Java que vous utilisez actuellement, exécutez java -jar newrelic.jar -v. Votre version d'agent Java sera imprimée sur votre console.

Ensuite, pour mettre à jour vers la dernière version de l'agent Java :

1. Sauvegardez l’ intégralité du répertoire racine de l’agent Java vers un autre emplacement. Renommez ce répertoire en NewRelic_Agent#.#.#, où #.#.# est le numéro de version de l'agent.
2. Télécharger l'agent.
3. Décompressez le nouveau fichier de téléchargement de l'agent, puis copiez newrelic-api.jar et newrelic.jar dans le répertoire racine de l'agent Java d'origine.
4. Comparez votre ancien newrelic.yml avec le newrelic.yml nouvellement téléchargé à partir du zip et mettez à jour le fichier si nécessaire.
5. Redémarrez votre répartiteur Java.

Si vous rencontrez des problèmes après la mise à jour de l'agent Java, effectuez la restauration à partir du répertoire de l'agent New Relic sauvegardé.

Différences de configuration de l'agent de mise à jour

Nous ajoutons de nouveaux paramètres à newrelic.yml à mesure que nous sortons de nouvelles versions de l'agent. Vous pouvez utiliser diff ou un autre utilitaire de comparaison pour voir ce qui a changé et ajouter les nouveaux paramètres de configuration à votre ancien fichier. Assurez-vous de ne pas écraser les personnalisations que vous avez apportées au fichier, telles que votre clé de licence, le nom de l'application ou les modifications apportées aux paramètres par défaut.

Par exemple, si vous diff les fichiers par défaut newrelic.yml pour les versions 7.10.0 et 7.11.0 de l'agent Java, les résultats imprimés sur la console seront comme suit :

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

Dans cet exemple, ces lignes ont été ajoutées à la valeur par défaut newrelic.yml dans la version 7.11.0 de l'agent Java. Si vous passez à la version 7.11.0 ou supérieure, vous devez ajouter ces nouvelles lignes à votre newrelic.yml d'origine.

Déclaration de soutien :

• New Relic vous recommande de mettre à niveau l'agent régulièrement pour vous assurer de bénéficier des dernières fonctionnalités et avantages en termes de performances. De plus, les anciennes sorties ne seront plus prises en charge lorsqu'elles atteindront leur fin de vie.

Nouvelle fonctionnalité et améliorations

• Ajout de la prise en charge de Java 25 par @deleonenriqueta dans la version 2512
• Ajout de la prise en charge de Logback-1.5.20 par @jtduffy dans la version 2535
• Introduit une option de configuration pour désactiver l'exécution des expressions régulières call et exec du parseur SQL par @jtduffy dans 2490
• Ajout de la prise en charge Coroutines Kotlin v1.4+ par @dhilpipere dans la version 2454
• Ajoute la prise en charge des fonctions suspendues Coroutines Kotlin générées en dehors des Coroutines Kotlin par @dhilpipere dans la version 2456.
• Introduit une configuration de préférence pour plusieurs hôtes lors de la détection datastore par @jbedell-newrelic dans la version 2508.
• Ajoute une propriété système pour configurer la fonction d'ignorance des artefacts par @jtduffy dans la version 2509
• Ajoute une option de configuration permettant de nommer les transactions du contrôleur Spring en utilisant le nom de la classe et le nom de la méthode du contrôleur (par @sharvath-newrelic dans la version 2532).
• Implémentation de SamplerConfig, centralisant toutes les configurations distributed_tracing.sampler dans SamplerConfig par @jasonjkeller dans 2529
• Mise à jour de l'instrumentation du producteur kafka-clients-spans-0.11.0.0 pour utiliser les API de tracing distribué modernes avec prise en charge W3C Trace Context par @sharvath-newrelic dans la version 2516

Corrections

• Correction de l'analyse des noms de classes d'erreurs par @sharvath-newrelic dans la version 2497
• Corrige un problème potentiel de mémoire causé par des traces d'appels excessivement longues dans le logging des erreurs (par @jtduffy dans la PR 2498).
• Clarifier les messages de logging pour l'attribut non valide sur l'événement personnalisé et le logging de l'événement par @sharvath-newrelic en 2501

Dépréciations

Les modules d'instrumentation suivants sont obsolètes et seront retirés lors de la prochaine mission majeure.

• 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

Mise à jour vers la dernière version

Pour identifier la version de l’agent Java que vous utilisez actuellement, exécutez java -jar newrelic.jar -v. Votre version d'agent Java sera imprimée sur votre console.

Ensuite, pour mettre à jour vers la dernière version de l'agent Java :

1. Sauvegardez l’ intégralité du répertoire racine de l’agent Java vers un autre emplacement. Renommez ce répertoire en NewRelic_Agent#.#.#, où #.#.# est le numéro de version de l'agent.
2. Téléchargez l'agent..
3. Décompressez le nouveau fichier de téléchargement de l'agent, puis copiez newrelic-api.jar et newrelic.jar dans le répertoire racine de l'agent Java d'origine.
4. Comparez votre ancien newrelic.yml avec le newrelic.yml nouvellement téléchargé à partir du zip et mettez à jour le fichier si nécessaire.
5. Redémarrez votre répartiteur Java.

Si vous rencontrez des problèmes après la mise à jour de l'agent Java, effectuez la restauration à partir du répertoire de l'agent New Relic sauvegardé.

Différences de configuration de l'agent de mise à jour

Nous ajoutons de nouveaux paramètres à newrelic.yml à mesure que nous sortons de nouvelles versions de l'agent. Vous pouvez utiliser diff ou un autre utilitaire de comparaison pour voir ce qui a changé et ajouter les nouveaux paramètres de configuration à votre ancien fichier. Assurez-vous de ne pas écraser les personnalisations que vous avez apportées au fichier, telles que votre clé de licence, le nom de l'application ou les modifications apportées aux paramètres par défaut.

Par exemple, si vous diff les fichiers par défaut newrelic.yml pour les versions 7.10.0 et 7.11.0 de l'agent Java, les résultats imprimés sur la console seront comme suit :

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

Dans cet exemple, ces lignes ont été ajoutées à la valeur par défaut newrelic.yml dans la version 7.11.0 de l'agent Java. Si vous passez à la version 7.11.0 ou supérieure, vous devez ajouter ces nouvelles lignes à votre newrelic.yml d'origine.

Déclaration de soutien :

• New Relic vous recommande de mettre à niveau l'agent régulièrement pour vous assurer de bénéficier des dernières fonctionnalités et avantages en termes de performances. De plus, les anciennes sorties ne seront plus prises en charge lorsqu'elles atteindront leur fin de vie.