New Relic recopila y reporta información sobre transacciones web y transacciones no web, como tareas en segundo plano. New Relic normalmente produce información completa de forma automática, sin necesidad de modificar el código de su aplicación. Sin embargo, si no utiliza un frameworkcompatible, es posible que deba agregar instrumentación personalizada.
La instrumentación personalizada también es útil para:
- Añade detalles a tu traza de la transacción.
- Bloquear instrumentación en transacciones seleccionadas que no desea instrumentar.
- Instrumento una parte de su código que New Relic simplemente no está captando.
La instrumentación personalizada que crea una nueva transacción recopila tanto el intervalo de tiempo de métrica como los datos del evento . La instrumentación personalizada para transacciones ya instrumentadas recopila solo datos de intervalo de tiempo de métrica.
Importante
No utilice corchetes [suffix] al final del nombre de su transacción. New Relic elimina automáticamente los corchetes del nombre. En su lugar, utilice paréntesis (suffix) u otros símbolos si es necesario.
Cuándo utilizar instrumentación personalizada
La instrumentación personalizada le permite realizar un seguimiento de las interacciones que no son capturadas por la instrumentación automática de New Relic. La instrumentación personalizada también puede agregar detalles a su traza de la transacción, para ayudarlo a identificar problemas clave.
New Relic recopila datos de muchos marcos automáticamente. Si está utilizando un frameworkcompatible, no debería necesitar instrumentación personalizada para recopilar segmentos de tiempo, eventos y trazas métricas.
Sin embargo, si se encuentra con alguna de estas situaciones, es posible que necesite instrumentación personalizada:
- Las transacciones no aparecen en la UI.
- La traza de la transacción incluye grandes bloques de tiempo de código de aplicación sin detalles completos.
Si está utilizando un frameworkcompatible, pero no ve la transacción en la página APMTransactions , obtenga soporte en support.newrelic.com para asegurarse de que la instrumentación framework esté funcionando.
Implementar instrumentación personalizada
Cada agente implementa instrumentación personalizada de manera diferente:
Problemas de agrupación
Se produce un problema de agrupación de métricas cuando una cuenta envía demasiados intervalos de tiempo de métricas con nombres diferentes a New Relic, y esas transacciones individuales en la web no se agregan correctamente. Por ejemplo, en lugar de un único nombre de métrica /user/controlpanel/ , es posible que vea /user/controlpanel/alice, /user/controlpanel/bob y /user/controlpanel/carol.
La instrumentación personalizada puede causar problemas de agrupación métrica si introduce demasiados intervalos de tiempo métricos con nombres únicos que New Relic no puede agrupar de manera efectiva. Si envía miles de métricas, New Relic puede aplicar reglas para reducir el número de transacciones.