New Relic Documentation

Nouvelle fonctionnalité et améliorations

Prise en charge de Java 19 1022
Prise en charge de Play 2.8.16+ 981
Prise en charge de ojdbc8 v21.1.0.0+ 1042
Prise en charge des JVM Semeru/OpenJ9 993
Prise en charge du transfert de logs pour java.util.logging (JUL) 1049
Prise en charge du transfert des données de contexte de log 866
L'Agent peut désormais transmettre les données du Mapped Diagnostic Context (MDC, logback/slf4j) et du ThreadContext (log4j2) sous forme d'attributs lors du transfert des enregistrements de logs. Lorsque la fonctionnalité est activée, ces attributs seront ajoutés aux enregistrements de log avec un préfixe context.. Pour plus de détails sur l'activation de cette fonctionnalité, consultez la documentation relative à context_data.
Augmentation de la limite des événements personnalisés 1036
Cette version augmente la limite par défaut des événements personnalisés de 10 000 événements par minute à 30 000 événements par minute. Dans le cas où les événements personnalisés étaient limités, ce changement permettra d’envoyer davantage d’événements personnalisés à New Relic. Il existe également une nouvelle limite maximale configurable de 100 000 événements par minute. Pour modifier les limites, consultez la documentation de max_samples_stored. Pour en savoir plus sur ce changement et comment déterminer si des événements personnalisés sont rejetés, consultez notre publication sur l’Explorers Hub.
Métriques au niveau du code activées par défaut 1037
La fonctionnalité de métriques au niveau du code introduite avec l'Agent 7.10 est désormais activée par défaut. Cette fonctionnalité entraînera une augmentation de la consommation de données. La quantité dépend de l'application. Pour désactiver les métriques au niveau du code, consultez les instructions de notre documentation sur les métriques au niveau du code.

Corrections

Empêcher la levée d'une exception dans l'instrumentation Jedis 1011
Amélioration des transactions Http4s 1006
Correction de l'API noticeError qui ne vérifiait pas si les erreurs étaient attendues 1014
Ajoute une commande pour les requêtes Lettuce vers les clusters 1031
Correction d'une exception lors de la construction du JAR de l'agent à partir d'un dépôt propre 1048
Meilleure gestion des erreurs pour les métriques au niveau du code 1021 1051
Correction des spans HttpUrlConnection ne se terminant pas lors d'une exception 1053

Avis de dépréciation

Les modules d'instrumentation suivants sont dépréciés en vue de leur suppression :

cassandra-datastax-2.1.2
httpclient-3.0
jdbc-embedded-derby-10.10.1.1
jetée-7
jetée-7.6
jetée-9
jetée-9.0.4
jetée-9.1
mongodb-2.12
mongodb-2.14
mongodb-3.0
okhttp-3.0.0
okhttp-3.4.0
okhttp-3.5.0

Les attributs de transaction/span httpResponseCode, response.status et response.statusMessage sont obsolètes et seront supprimés dans une future version. Ceux-ci ont été remplacés par http.statusCode et http.statusText.

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.

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