APM pour Java produira généralement automatiquement des données de performances utiles. Cependant, si New Relic ne prend pas en charge votre framework, ou si vous souhaitez mettre en place monitoring supplémentaire, vous souhaiterez implémenter instrumentation personnalisée.
instrumentation personnalisée vous permet de suivre les interactions qui ne sont pas capturées par l'instrumentation automatique de New Relic et vous permet d'ajouter des détails à votre trace de transaction, pour vous aider à identifier les problèmes clés.
New Relic collecte automatiquement les métriques et événements de nombreux frameworks. Si vous utilisez un framework ou un composant pris en charge, vous pouvez voir certaines informations de transaction prêtes à l'emploi et une instrumentation personnalisée peut être utilisée pour compléter les informations signalées par défaut par l'agent.
Important
Si vous utilisez un framework pris en charge, mais que vous ne voyez pas de transactions, obtenez de l'aide sur support.newrelic.com pour vous assurer que l'instrumentation du framework fonctionne.
Quand choisir une instrumentation personnalisée
Choisissez une instrumentation personnalisée dans ces situations :
- New Relic ne prend pas en charge votre framework et les transactions n'apparaissent pas dans l'UI
- Vous souhaitez ajouter des détails à votre trace de transaction
- les traces de transaction incluent de gros blocs de temps
application codesans suffisamment de détails
Mettre en œuvre une instrumentation personnalisée
Vous pouvez implémenter une instrumentation personnalisée avec l’une de ces méthodes :
Method | Description |
|---|---|
L'UI de New Relic | New Relic pour Java inclut une option dans l'UI pour instrumentation personnalisée appelée l'éditeur d'instrumentation personnalisée. Cette option ne nécessite aucune modification directe du code de votre application, c'est donc un bon choix si vous ne souhaitez pas ou ne pouvez pas modifier votre code. L'éditeur est cependant assez limité en termes de fonctionnalités par rapport à l'API de l'agent Java. |
Annotation API | À l’aide de l’agent Java de New Relic API, vous pouvez annoter les méthodes de votre application code que vous souhaitez monitorer. La méthode d’annotation est robuste et facile à dépanner. Si vous souhaitez modifier votre code source, l'annotation est la méthode recommandée. Si vous avez de nombreuses méthodes à instrument, vous préférerez peut-être instrumentationXML. Pour en savoir plus sur l'API et ses autres fonctions, consultez Introduction à l'API de l'agent Java. |
XML | Si vous ne pouvez pas modifier votre code, ou si vous avez besoin d'instrumenter de nombreuses méthodes, instrumentation XML est la meilleure méthode instrumentation personnalisée. Avec cette méthode, vous spécifiez les classes que vous souhaitez instrumenter dans un fichier XML externe. Bien que l’instrumentation XML soit puissante, elle est également plus difficile à utiliser que les autres méthodes d’instrumentation. Pour des besoins instrumentation plus simples, New Relic recommande l'annotation ou instrumentation via l'UI. Pour plus d'informations, voir Instrumentation Java par XML. |
Vous pouvez également monitorer Java Management Extensions (JMX) via instrumentation personnalisée. JMX est un moyen de monitorer et de gérer les applications, les appareils et les services. Vous pouvez implémenter monitoring JMX via un fichier YAML externe.