Java agent release notesRSS

New features and improvements

• Java 27 support 3095
• AI Monitoring - Support for AWS Converse APIs 2995 3003
• Support Quarkus: rest-3.0.0 3009
• Support Quarkus resteasy 2.14 3018
• Support Spring Boot Actuator v4 3040
• Support for Ktor Http Clients, Http Server and Utils (Pipelines) 2892 2894 2895
• Support for Redisson 3.28.0 and up 3050
• Adobe AEM (Sling) browser script injection modules 2863
• Oracle explain plan support 3080

Enhancements

• Add (limited) Hybrid Agent proxy support 3013
• Hybrid Agent - Logging - Allow empty message body when context attributes are present 3042
• Add hybrid audit logging 3059
• Enhance gRPC-Netty support 3063
• Enable Hybrid Agent OTLP metric retry logic 3084
• Add collector connection TTL and recovery tests 3081
• Make weave related task thread count configurable 3103
• Report Cluster Ids in Kafka Metrics 3054

Fixes

• Properly handle exceptions thrown from the normalizer flow 3037
• Resolve Micronaut duplicate transactions/lost custom attributes issues 3085

IAST

• Bump CSEC agent version to v1.8.0 3065 Changelog: https://github.com/newrelic/csec-java-agent/releases#release-1.8.0

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

• Suppression du blob de métadonnées de liaison @NewFields du module log4j-2.11 2917
• Ajout de la prise en charge du mode cluster dans les modules lettuce-6.0 et lettuce-6.5 2922
• Ajout de nouveaux modules d'instrumentation pour Vert.x web et core 5.x 2920
• Ajout de nouveaux modules d'instrumentation Java Server Faces pour remplacer les point cuts legacy 2944
• Ajout d'un nouveau module Portlet pour remplacer les point cuts legacy 2953
• Migration du plug-in shadow de com.github.johnrengelman vers com.gradleup 2945
• Ajout du remplacement de l'instrumentation de classe weave pour le point cut HandlerMethodInvoker3PointCut 2967
• Suppression des annotations @NewField du module jdbc-generic 2963
• Suppression du point cut HandlerMethodInvokerPointCut 2977
• Suppression du point cut SpringPointCut 2990
• Ajout d'un nouvel attribut http.request.method à tous les spans HTTP externes 2985 3010
• Ajout de la prise en charge de la décoration des données JFR avec des étiquettes APM (telles que configurées dans l'agent Java) 3007
• [Hybrid Agent] Décoration des métriques dimensionnelles OpenTelemetry avec otlp_resource_attributes à partir de la réponse de connexion 2956

Corrections

• Correction du problème de fuite MDC dans le apache-log4j-2.11 module 2926
• Suppression des exceptions avec espace de noms java.rmi 2932
• Utilisation de l'attribut d'exception de servlet Jakarta dans le module wildfly-27 2929
• Le mode Serverless envoie désormais la charge à la console si le pipe de fichier n'a pas été écrit 2975
• Modification du log ForceRestartException en INFO 2989
• Ajout d'une nouvelle instance Patcher au moment de la compilation pour supprimer les valeurs d'énumération problématiques de la classe @NullMarked de la bibliothèque jspecify shadow 2982
• Nettoyage des instance de segment pour les appels HTTP Netty Reactor 3004
• Correction des métadonnées de liaison de transaction lors de certaines opérations asynchrones 3006

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 recommande de mettre à jour l'agent régulièrement pour vous assurer de bénéficier des dernières fonctionnalités et améliorations de performances. De plus, les anciennes versions ne seront plus prises en charge lorsqu'elles atteindront la fin de vie.

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.