A New Relic coleta e relata informações sobre transação da web e transação fora da web, como tarefas em segundo plano. O New Relic normalmente produz informações completas automaticamente, sem qualquer necessidade de modificar o código do seu aplicativo. No entanto, se você não estiver usando uma framework compatível, talvez seja necessário adicionar instrumentação personalizada.
A instrumentação personalizada também é útil para:
- Adicione detalhes ao seu rastreamento da transação.
- Bloqueie a instrumentação na transação selecionada que você não deseja instrumentada.
- Instrumento uma parte do seu código que a New Relic simplesmente não está captando.
A instrumentação personalizada que cria uma nova transação coleta métricas de fração de tempo e dados de eventos . A instrumentação personalizada para transações já instrumentadas coleta apenas dados métricos de fração de tempo.
Importante
Não use colchetes [suffix] no final do nome da sua transação. O New Relic remove automaticamente os colchetes do nome. Em vez disso, use parênteses (suffix) ou outros símbolos, se necessário.
Quando usar 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. A instrumentação personalizada também pode adicionar detalhes ao rastreamento da transação, para ajudá-lo a identificar os principais problemas.
A New Relic coleta dados de muitas estruturas automaticamente. Se você estiver usando uma frameworksuportada, não precisará de instrumentação customizada para coletar intervalos de tempo, eventos e rastreamentos métricos.
No entanto, se você encontrar alguma dessas situações, poderá precisar de instrumentação personalizada:
- Transações não aparecem na interface.
- O rastreamento da transação inclui grandes blocos de tempo de código do aplicativo sem detalhes completos.
Se você estiver usando uma frameworksuportada, mas não estiver vendo a transação na páginaTransactions do APM, obtenha suporte em support.newrelic.com para garantir que a instrumentação framework esteja funcionando.
Implementar instrumentação personalizada
Cada agente implementa instrumentação personalizada de maneira diferente:
Problemas de agrupamento
Um problema de agrupamento métrico ocorre quando uma conta envia muitos intervalos de tempo métricos com nomes diferentes para o New Relic, e essas transações individuais da web não são agregadas adequadamente. Por exemplo, em vez de um único nome de métrica /user/controlpanel/ , você poderá ver /user/controlpanel/alice, /user/controlpanel/bob e /user/controlpanel/carol.
A instrumentação personalizada pode causar problemas de agrupamento métrico se você introduzir muitos intervalos de tempo métricos com nomes exclusivos que o New Relic não consegue agrupar com eficiência. Se você enviar milhares de métricas, a New Relic poderá aplicar regras para reduzir o número de transações.