New Relic Documentation

Téléchargez cette version de l'agent

Nouvelle fonctionnalité et améliorations

Prise en charge du CRaC 2250
Prise en charge de JDK24 2284
Options d'échantillonnage ajoutées lorsqu'un traceparent entrant existe 2279
- Ces options définissent la manière dont l'agent doit gérer l'échantillonnage des étendues, en fonction des décisions d'échantillonnage prises pour leur parent d'étendue par une entité en amont. Les options configuration remote_parent_sampled et remote_parent_not_sampled spécifient ce qu'il faut faire dans le cas où le parent span a été échantillonné ou non échantillonné, respectivement. Consultez la documentation pour obtenir tous les détails de configuration.
Prise en charge d'Undertow en tant que module autonome 2269
- Cette instrumentation est désactivée par défaut pour éviter les conflits avec l'instrumentation Wildfly existante. Pour activer cette instrumentation pour les applications serveur Undertow autonomes, utilisez le paramètre de configuration :
```
class_transformer:
   com.newrelic.instrumentation.undertow-server-1.1.0:
     enabled: true
```
Prise en charge du client Couchbase 2203
- Si le module expérimental du client Couchbase est actuellement utilisé, supprimez-le de votre répertoire d'extensions avant de procéder à la mise à niveau vers cette version de l'agent Java.

Corrections

Correction des transactions « inconnues » de Netty 2274
- Ce correctif déplace les modifications d'instrumentation Netty précédentes derrière un indicateur de fonctionnalité, ce qui offre une visibilité supplémentaire dans certains cas impliquant des transactions HTTP2. Pour réactiver cette granularité (au prix possible de voir des transactions « inconnues »), utilisez le paramètre de configuration :
```
netty:
    http2:
      frame_read_listener:
        start_transaction: true
```
Refactorisation de la récupération d'ID AWS Docker pour utiliser le délai d'expiration de 5 s 2275
Indicateur de fonctionnalité pour appliquer le correctif Kotlin ArrayIndexOutOfBoundsException à toutes les méthodes 2307
- Ce correctif corrige les erreurs qui peuvent être observées lors de l’exécution de l’agent Java dans un environnement où les fonctions de suspension de Kotlin sont utilisées. Pour utiliser ce correctif, définissez la propriété système -Dnewrelic.config.class_transformer.clear_return_stacks=true
Empêcher le verrouillage du cache pour l'analyse des instructions de base de données longues 2294
Ajouter une configuration pour spécifier si java.sql est chargé par le chargeur de classe de la plateforme 2267

Dépréciations

Les modules d'instrumentation suivants sont obsolètes et seront supprimés lors de la prochaine sortie majeure :

aws-wrap-0.7.0
java.completable-future-jdk8
play-2.3
netty-3.4
Struts v1

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 :

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.
Téléchargez l'agent..
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.
Comparez votre ancien newrelic.yml avec le newrelic.yml nouvellement téléchargé à partir du zip et mettez à jour le fichier si nécessaire.
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.
>       include_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.