Nouvelle fonctionnalité et améliorations

• Ajout de la prise en charge de Webflux 6 1181

• Ajout de la prise en charge de Spring JMS 6 1088

• Ajout de la prise en charge de Mongodb Reactive Streams 1164

• Ajout de la prise en charge de Kafka Streams 1170

  La prise en charge de Kafka Streams se décline en deux volets : les métriques et les spans. Les métriques sont activées par défaut, tandis que les spans sont désactivés par défaut. Pour activer les spans, ajoutez ce qui suit à votre configuration newrelic.yml dans la section common :

common:
  class_transformer:
    kafka-streams-spans:
      enabled: true

• Empreinte d'erreur - fournissez vos propres noms de groupes Errors Inbox 1195

  Vos occurrences d’erreurs sont-elles mal regroupées ? Définissez votre propre empreinte d’erreur via une fonction de rappel. Une nouvelle méthode d’API publique a été ajoutée qui acceptera une procédure définie par l’utilisateur. La proc sera invoquée pour chaque erreur détectée et chaque fois qu’elle renvoie une chaîne, cette chaîne sera utilisée comme nom de groupe d’erreurs pour l’erreur et aura la priorité sur tout regroupement côté serveur effectué avec l’Errors Inbox de New Relic. Cela offre aux utilisateurs un contrôle bien plus grand sur le regroupement de leurs erreurs. Pour plus d’informations, consultez nos pages API : regroupement d’erreurs et APM : onglet Groupes d’erreurs.

• Suivi des utilisateurs - associer les erreurs à un identifiant utilisateur 1188

  Vous pouvez désormais voir le nombre d'utilisateurs impactés par un groupe d'erreurs. Identifiez l’utilisateur final avec une nouvelle méthode d’API publique qui accepte une représentation sous forme de chaîne d’un identifiant utilisateur et associe cet identifiant à la transaction en cours. Les transactions et les erreurs auront alors un nouvel attribut d’agent enduser.id associé. Cela permettra aux utilisateurs de l’agent de marquer d’un tag les transactions et les erreurs comme appartenant à des identifiants utilisateur donnés, afin d’améliorer les capacités de filtrage et d’alerte. Pour plus d’informations, consultez la documentation [Newrelic.setUserId ](https://newrelic.github.io/java-agent-api/javadoc/com/newrelic/api/agent/NewRelic.html#setUserName(java.lang.String) et la page Suivre les utilisateurs impactés avec Errors Inbox.

• L'appel de token.link() en dehors d'une transaction instrumentera cette méthode pour démarrer une transaction asynchrone 1140

• L'instrumentation des clients Kafka comporte de nouvelles métriques pour lister les nœuds : MessageBroker/Kafka/Nodes/<node> 1130

Corrections

• Correction de ClassCircularityError lorsque l'agent s'attache 1137
• Correction de la NullPointerException levée lors de l'appel de addCustomAttributes 1115
• Assurez-vous que TokenAndRefCount.token n'est jamais null 1149
• Utilisation d'un cache basé sur le temps pour stocker les données de connexion à la base de données afin d'éviter une fuite de mémoire lors de l'instrumentation du client MySQL avec réplication 1114
• Réduction du nombre de threads utilisés dans l'instrumentation HttpUrlConnection 1145
• Correction d'un problème lors de l'utilisation de HttpUrlConnection avec l'ancien tracing inter-applications 1142
• Amélioration des performances dans le RequestWrapper de Netty 1163
• Arrêter proprement l'agent s'il rencontre des problèmes au démarrage 1136
• Corriger les annotations WeavedMethod et InstrumentedMethod lorsqu'elles sont appliquées aux constructeurs. 1153
• Améliorations des performances lors de l'utilisation de Tomcat 1131
• Correction d'un bug empêchant l'agent de signaler certaines exceptions 1176
• Mise à jour de DockerData pour augmenter le nombre d'identifiants de conteneurs détectés 1178
• Réduire le nombre de threads utilisés dans l'instrumentation des clients Kafka 1056
• Modifications grammaticales [1175](https://github.com/newrelic/newrelic-java-agent/pull/1175 et [1190]https://github.com/newrelic/newrelic-java-agent/pull/1190)

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 au newrelic.yml par défaut 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.