Java agent release notesRSS

Nouvelle fonctionnalité et améliorations

• Prise en charge de Java 27 3095
• Monitoring de l’IA - Prise en charge des API AWS Converse 2995 3003
• Prise en charge de Quarkus : rest-3.0.0 3009
• Prise en charge de Quarkus resteasy 2.14 3018
• Prise en charge de Spring Boot Actuator v4 3040
• Prise en charge des clients HTTP, du serveur HTTP et des utilitaires Ktor (pipeline) 2892 2894 2895
• Prise en charge de Redisson 3.28.0 et versions ultérieures 3050
• Modules d’injection de script de navigateur Adobe AEM (Sling) 2863
• Prise en charge du plan d’exécution Oracle 3080

Améliorations

• Ajouter la prise en charge (limitée) du proxy pour l’Agent hybride (Hybrid Agent) 3013
• Agent hybride - Logging - Autoriser un corps de message vide lorsque des attributs de contexte sont présents 3042
• Ajout du logging d'audit hybride 3059
• Améliorer la prise en charge de gRPC-Netty 3063
• Activer la logique de nouvelle tentative de métrique OTLP de l'agent hybride 3084
• Ajouter des tests de récupération et de TTL de connexion au collecteur 3081
• Rendre configurable le nombre de threads des tâches liées à weave 3103
• Signaler les ID de Cluster dans les Métriques Kafka 3054

Corrections

• Gérer correctement les exceptions levées par le flux du normalisateur 3037
• Résoudre les problèmes de transactions dupliquées / d'attributs personnalisés perdus dans Micronaut 3085

IAST

• Mettre à jour la version de l'agent CSEC vers v1.8.0 3065 changelog : https://github.com/newrelic/csec-java-agent/releases#release-1.8.0

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

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