Java agent release notesRSS

New features and improvements

• Removed linking metadata blob @NewFields from log4j-2.11 module 2917
• Added support for cluster mode in the lettuce-6.0 and lettuce-6.5 modules 2922
• Added new instrumentation modules for Vert.x web and core 5.x 2920
• Added new Java Server Faces instrumentation modules to replace legacy point cuts 2944
• Added a new Portlet module to replace legacy point cuts 2953
• Migrated shadow plugin from com.github.johnrengelman to com.gradleup 2945
• Added weave class instrumentation replacement for HandlerMethodInvoker3PointCut point cut 2967
• Removed @NewField annotations from the jdbc-generic module 2963
• Removed HandlerMethodInvokerPointCut point cut 2977
• Removed SpringPointCut point cut 2990
• Added new http.request.method attribute to all external HTTP spans 29853010
• Added support for decorating JFR data with APM labels (as configured in the java agent) 3007
• [Hybrid Agent] Decorated OpenTelemetry dimensional metrics with otlp_resource_attributes from connect response 2956

Fixes

• Fixed MDC leak issue in the apache-log4j-2.11 module 2926
• Removed java.rmi namespaced exceptions 2932
• Used Jakarta servlet exception attribute in the wildfly-27 module 2929
• Serverless mode now sent payload to the console if file pipe wasn't written 2975
• Changed ForceRestartException log to INFO 2989
• Added a new build time Patcher instance to remove problem enum values from the shadowed jspecify library @NullMarked class 2982
• Cleaned up segment instances for Netty Reactor HTTP calls 3004
• Fixed transaction linking metadata during some async operations 3006

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

• Ajouter la configuration log_level_denylist au yaml par défaut 2830

• Module JMX Solr 9 2821

• Nouvelle stratégie centralisée de comptage des jetons pour capturer le nombre de jetons à partir des réponses des LLM. 2837

• Prise en charge de la capture des opérations par lots JDBC ; spécifiquement les méthodes addBatch() et executeBatch(). 2840

• Module d'instrumentation XML RPC pour remplacer le point de coupe legacy 2841

• Ajouter une nouvelle configuration spécifique à JFR jfr.use_display_name. Si défini sur true, l'agent définira le nom d'hôte JFR sur la valeur de la configuration process_host.display_name. La valeur par défaut est false pour préserver l'ancien comportement.

Si jfr.use_display_name est true mais que la configuration display_name est vide, le JfrService reviendra à l’ancien comportement pour le nom d’hôte.

common: &default_settings
  jfr:
    use_display_name: true

2847

• Supprimer la création inutile de segments dans le module java.xmlrpc 2853

• Mise à jour du module aws-bedrock-runtime-2.20 avec une nouvelle stratégie de comptage de jetons pour chacun des modèles. 2845

• Nouvel algorithme d'obfuscation de clé de licence 2864

• Prise en charge des clients HTTP Micronaut versions 3.5.0+ 2834

• Prise en charge d'Apache Camel 3.9.0 et versions ultérieures 2896 2901

• Prise en charge des clients Kafka 4.0.0 et versions ultérieures 2896

• Mise à niveau de la dépendance interne Log4j Core de 2.17.1 à 2.25.4 2833

• Prise en charge d'AWS DAX à partir de 2.0.0 jusqu'à la dernière version 2873

• Ajout de l'instrumentation pour les clients de complétion et d'incorporation (embedding) Spring AI pour les versions 1.0.0 et ultérieures. Ceci ajoute de nouveaux modules d'instrumentation :

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

2842

• Tracing de base - supprimer les SpanEvents et reparenter les SpanLinks supprimés 2881

• Remplacements de pointcuts

  • Supprimer SpringDispatcherPointCut et SpringExceptionHandlerPointCut et déplacer plutôt la fonctionnalité dans nos modules d'instrumentation Spring.
  • Remplacer HandlerInterceptorPointCut 2871 2886

• Prise en charge du BlockingHttpClient de Micronaut 2860

• Ajouter la prise en charge du protocole de contexte de modèle d'IA 1.0.0 à la dernière version. 2880

Corrections

• Correction de l'instrumentation des coroutines. Les corrections incluent :

  • Meilleur suivi du comportement asynchrone en ayant instrumenté les lacunes qui ont été trouvées là où l'exécution peut passer à un autre thread.
  • Meilleur nommage des Coroutines et des continuations. Le nommage existant était trop générique. Le nouveau nommage identifie selon qu'il est démarré via runBlocking, async, withContext, ou lancement.
  • Suppression de certaines méthodes utilitaires qui n'étaient plus utilisées 2802

• Corrige le nombre excessif de jetons asynchrones non expirés lorsque Micronaut est instrumenté. 2792

• Résolution de l’erreur IllegalAccessError de Mule 4.9 2859

• Correction d’un enregistrement erroné des métriques instrumentées et conservées pour Core Tracing, car elles étaient initialement enregistrées comme une métrique de temps. 2881

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

• Ajoute la prise en charge de Java 26 2734
• Ajoute le mode Serverless pour le monitoring AWS Lambda avec l’agent Java 2609 2615 2625 2633 2640 2641 2647 2673 2716 2721 2735 2723 2740 2769 2782 2794 2797 2796 2806
• Ajoute une nouvelle configuration application_logging.forwarding.log_level_denylist 2764
• Implémente les URI d'ingestion d'événements/métriques sensibles à la région 2749 2790
• Ajoute la prise en charge de l'association des logs à l'entité correspondante lorsque enable_auto_app_naming est true 2627
• Ajouter l'instrumentation opentelemetry-sdk-extension-autoconfigure-1.59.0 pour OpenTelemetry 1.59.0+ 2786
• Ajoute la prise en charge de l'association de l'échantillonneur adaptatif à l'entité correspondante lorsque enable_auto_app_naming est true 2805
• Ajoute des métriques de supportabilité pour chaque entité créée lorsque enable_auto_app_naming est true 2808
• Implémente la configuration du proxy de contournement des métadonnées cloud 2791
• Ajoute la prise en charge de plusieurs versions de Caffeine dans l'agent 2807
• Ajoute la prise en charge des plans d’exécution qui utilisent des éventails SQL 2815
• Ajoute une « Queue » générique comme type de transport 2820
• Ajoute la prise en charge des appels du client Http Reactor Netty 2817

Corrections

• Corrige un cas limite où des charges mal formées provoquaient une NPE lors de l'accès au champ sampled sur la charge NR 2762
• Expire les jetons lorsqu'un abonnement réactif est annulé 2798
• Ajoute une logique pour retirer manuellement tout thread mort du cache TheadTracker afin d'éviter une fuite de mémoire 2811
• Résout un interblocage entre le thread de collecte et le thread d'arrêt de la JVM 2539

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

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