O APM para Java normalmente produzirá dados de desempenho úteis automaticamente. No entanto, se o New Relic não oferece suporte à sua framework ou se você deseja configurar monitoramento adicional, você desejará implementar instrumentação personalizada.
A instrumentação personalizada permite rastrear interações que não são capturadas pela instrumentação automática do New Relic e permite adicionar detalhes ao seu rastreamento da transação, para ajudá-lo a identificar os principais problemas.
New Relic coleta métricas e eventos de vários frameworks automaticamente. Se você estiver usando uma framework ou componente compatível, poderá ver algumas informações de transação prontas para uso, e a instrumentação personalizada poderá ser usada para complementar as informações que o agente relata por padrão.
Importante
Se você estiver usando uma framework suportada, mas não estiver vendo a transação, obtenha suporte em support.newrelic.com para garantir que a instrumentação framework esteja funcionando.
Quando escolher instrumentação personalizada
Escolha instrumentação personalizada nestas situações:
- New Relic não suporta seu framework e transações não aparecem na interface
- Você gostaria de adicionar detalhes ao seu rastreamento de transação
- O rastreamento da transação inclui grandes blocos de tempo
application codesem detalhes suficientes
Implementar instrumentação personalizada
Você pode implementar instrumentação personalizada com um destes métodos:
Method | Description |
|---|---|
A interface da New Relic | O New Relic for Java inclui uma opção na interface para instrumentação customizada chamada Editor de instrumentação personalizada. Esta opção não requer nenhuma modificação direta no código do seu aplicativo, portanto é uma boa escolha se você não quiser ou não puder modificar seu código. O editor é, no entanto, bastante limitado em funcionalidade em comparação com a API do agente Java. |
Anotação de API | Usando a API do agente Java da New Relic, você pode anotar os métodos no código do aplicativo que deseja monitor. O método de anotação é robusto e fácil de solucionar. Se você deseja modificar seu código-fonte, a anotação é o método recomendado. Se você tiver muitos métodos que deseja instrumentar, talvez prefira a instrumentação XML. Para obter mais informações sobre a API e suas outras funções, consulte Introdução à API do agente Java. |
XML | Se você não puder modificar seu código ou precisar instrumentar vários métodos, a instrumentação XML é o melhor método de instrumentação personalizada. Com este método, você especifica as classes que deseja instrumentalizar em um arquivo XML externo. Embora a instrumentação XML seja poderosa, ela também é mais difícil de usar do que outros métodos de instrumentação. Para necessidades de instrumentação mais simples, a New Relic recomenda anotação ou instrumentação por meio da interface. Para mais informações, veja Instrumentação Java por XML. |
Você também pode monitor Java Management Extensions (JMX) via instrumentação personalizada. JMX é uma forma de monitor e gerenciar aplicativos, dispositivos e serviços. Você pode implementar o monitoramento JMX por meio de um arquivo YAML externo.