APM para Java normalmente producirá datos de rendimiento útiles de forma automática. Sin embargo, si New Relic no es compatible con su framework, o si desea configurar un monitoreo adicional, deberá implementar instrumentación personalizada.
La instrumentación personalizada le permite rastrear interacciones que no son capturadas por la instrumentación automática de New Relic y le permite agregar detalles a su traza de la transacción, para ayudarlo a identificar problemas clave.
New Relic recopila métricas y eventos de muchos marcos automáticamente. Si está utilizando un framework o componente compatible, es posible que vea cierta información de transacción lista para usar y se puede usar instrumentación personalizada para complementar la información que el agente informa de forma predeterminada.
Importante
Si está utilizando un framework compatible, pero no ve transacciones, obtenga soporte en support.newrelic.com para asegurarse de que la instrumentación framework esté funcionando.
Cuándo elegir instrumentación personalizada
Elija instrumentación personalizada en estas situaciones:
- New Relic no es compatible con su framework y las transacciones no aparecen en la UI
- Le gustaría agregar detalles a su traza de la transacción
- La traza de la transacción incluye grandes bloques de
application codetiempo sin suficiente detalle.
Implementar instrumentación personalizada
Puede implementar instrumentación personalizada con uno de estos métodos:
Method | Description |
|---|---|
La New Relic UIde reliquia | New Relic para Java incluye una opción en la UI para instrumentación personalizada llamada Editor de instrumentación personalizada. Esta opción no requiere ninguna modificación directa del código de su aplicación, por lo que es una buena opción si no desea o no puede modificar su código. Sin embargo, el editor tiene una funcionalidad bastante limitada en comparación con la API del agente de Java. |
Anotación API | Con la API New Relic agente de Java, puede anotar los métodos en el código de su aplicación que desea monitor. El método de anotación es sólido y fácil de solucionar. Si está dispuesto a modificar su código fuente, la anotación es el método recomendado. Si tiene muchos métodos que desea instrumentar, es posible que prefiera la instrumentación XML. Para obtener más información sobre la API y sus otras funciones, consulte Introducción a la API del agente de Java. |
XML | Si no puede modificar su código, o si necesita instrumentar muchos métodos, la instrumentación XML es el mejor método de instrumentación personalizada. Con este método, especificas las clases que deseas instrumentar en un archivo XML externo. Si bien la instrumentación XML es poderosa, también es más difícil de usar que otros métodos de instrumentación. Para necesidades de instrumentación más simples, New Relic recomienda anotaciones o instrumentación a través de la UI. Para más información, consulte Instrumentación Java por XML. |
También puede monitor Java Management Extensions (JMX) a través de instrumentación personalizada. JMX es una forma de monitor y administrar aplicaciones, dispositivos y servicios. Puede implementar el monitoreo JMX a través de un archivo YAML externo.