Avec l'agent Java de New Relic, vous pouvez suivre tout, des problèmes de performances aux petites erreurs dans votre code. Chaque minute, l'agent publie des données d'intervalle de temps métrique et d'événement sur l'interface utilisateur New Relic , où le propriétaire de ces données peut se connecter et utiliser les données pour voir les performances de son site Web.
Utilisez l'agent Java New Relic pour résoudre les problèmes de performances de votre application avec notre didacticiel Mon application est lente.
Conseil
Êtes-vous curieux des tendances Java ? Consultez notre rapport 2024 État de l'écosystème Java.
installation
Pour utiliser l’agent Java :
Assurez-vous que votre système répond à la compatibilité et aux exigences de l'agent Java.
Inscrivez-vous pour votre compte gratuit si vous ne l'avez pas déjà fait.
Installez l'agent Java à l'aide de notre lanceur ou en suivant les documents d'installation.
Pour afficher les performances de votre application dans l'UI de New Relic, accédez à one.newrelic.com > All capabilities > APM & services > (select an app) > Summary. L'interface utilisateur APM comprend une page JVM metrics dédiée, des détails sur les transactions et les erreurs , un outil de profileur de thread pour échantillonner les threads Java et signaler les traces d'appels, et bien plus encore.
Vous pouvez également étendre votre instrumentation d'agent et explorer vos données avec d'autres New Relic fonctionnalités , notamment notre explorateur et tableau de bord de métriques et d'événements .
configurationde démarrage
L'agent Java lit la configuration de démarrage à partir du fichier newrelic.yml , qui doit se trouver dans le même répertoire que newrelic.jar. Vous pouvez également remplacer les paramètres à l’aide des propriétés système Java.
L'agent a besoin des paramètres license_key et app_name au démarrage (bootstrap). Vous pouvez personnaliser l'emplacement du fichier de log et d'autres paramètres dans votre fichier newrelic.yml. De plus, vous pouvez ajuster la configuration de dénomination si votre serveur d’applications exécute plusieurs applications dans la même JVM.
Options de configuration
Vous pouvez configurer les rapports d'application à partir de l'interface Web New Relic à l'aide de la configuration côté serveur. Les modifications seront appliquées à tous les rapports d’agent de votre application lorsque la JVM redémarre. Cependant, si vous utilisez la configuration côté serveur, vous devez toujours conserver les paramètres requis (license_key et app_name) dans le fichier de configuration local.
Les traces de transaction et les instantanés d'erreur peuvent éventuellement enregistrer les paramètres HTTP. Parfois, les paramètres HTTP contiennent des informations sensibles, comme un numéro de carte de crédit. L'agent dispose de plusieurs optionsconfiguration pour assurer la sécurité des données, comme la collecte des paramètres HTTP mais l'exclusion de certains paramètres nommés.
Afficher les logs de vos données APM et infrastructure
Vous pouvez également rassembler vos données de log et d'application pour rendre le dépannage plus facile et plus rapide. Avec les logs en contexte, vous pouvez voir les messages de log liés à vos erreurs et les tracer directement dans UI de votre application. Vous pouvez également voir les logs en contexte de vos données infrastructure , telles que le cluster Kubernetes. Pas besoin de passer à une autre page UI .
instrumentationsupplémentaire
Après avoir installé l’agent Java, utilisez l’une de ces méthodes pour étendre votre instrumentation :
- instrumentation personnalisée : implémentez Java instrumentation personnalisée via une annotation ou XML.
- Activer le traçage distribué: visualisez les chemins de vos requests à mesure qu'elles se propagent dans une architecture distribuée à services multiples.
- Collecter l'attribut personnalisé : Collecter l'attribut personnalisé via API ou fichier XML.
- API de l'agent Java : utilisez l'API pour contrôler, personnaliser ou étendre les fonctionnalités de l'agent Java.
- instrumentation du navigateur : Intégrez l'agent Java avec pour obtenir une visibilité sur l'activité finale de l'utilisateur.
- disjoncteur pour Java instrumentation personnalisé : utilisez un disjoncteur pour protéger l'application contre lainstrumentation.
- instrumentation JMX personnalisée par YAML : affichez des métriques JMX personnalisées avec un fichier d'instrumentation YAML personnalisé.
- Page métriquesJVM : Collectez les métriques des serveurs application les plus courants via JMX.
- télémétrie open source : Nous proposons une variété d'outils, tels que Kamon Reporter, OpenTelemetry exportateur, Micrometer métriques Registry et Java télémétrie SDK.
Quand redémarrer votre JVM
Lorsque vous apportez une modification à votre configuration ou à votre XML personnalisé, dans presque tous les cas, vous devez redémarrer votre JVM. Il n'y a que quatre situations dans lesquelles un redémarrage n'est pas nécessaire :
JVM restart is not required for... | Comments |
|---|---|
Changements de niveau de logging ou de mode d'audit | Si vous modifiez simplement |
Fichier XML d'instrumentation personnalisée | Le redémarrage de la JVM dépend de la version de votre agent Java :
|
changements de disjoncteur | Si vous modifiez le disjoncteur pour l'instrumentation personnalisée Java, un redémarrage de la JVM n'est pas requis. |
Ignoré ou erroné | Si vous ignorez ou attendez des erreurs en configurant le fichier
|
Toutes les autres modifications nécessitent un redémarrage de l’agent, ce qui signifie le redémarrage de la JVM.
Conformité à la norme JSR 163
L'agent Java de New Relic monitore les transactions Web, reçoit des informations à leur sujet et communique ces informations à New Relic l'utilisateur de l'interface avec de fortes mesures de sécurité des données en place. L'agent est empaqueté sous la forme d'un javaagent conforme à JSR 163 qui est activé par la JVM via des modifications au lancement de la JVM . Une fois activé, l'agent s'insère dans le flux de chargement de classe et instrumente les méthodes de classe à l'aide de instrumentation de byte code (bci).
Conçues pour avoir un impact minimal sur votre application Web, toutes les classes sont dans le package newrelic espace de nommage afin qu'elles n'entrent pas en conflit avec vos propres classes. L'agent utilise le moteur ASM bci pour insérer des sondes logicielles.
L'agent reçoit des informations de base sur votre environnement hôte, telles que le système d'exploitation, Java la version , les propriétés du système et votre New Relic configuration fichier . L'agent interroge également les données de la JVM et de JMX.
Procédures de dépannage
Si vous rencontrez des problèmes, consultez Aucune donnée n'apparaît et d'autres documents de dépannage dans cette section.