Para marcos totalmente compatibles (.NET framework | .NET Core), el agente New Relic .NET recopila e informa automáticamente información sobre transacciones web y tareas browser . Sin embargo, si está utilizando un framework de aplicación que no está instrumentado automáticamente (o no utiliza un framework), es posible que vea grandes bloques de tiempo en la UI de New Relic sin detalles o que no vea ninguna transacción. En este caso, puede utilizar instrumentación personalizada para agregar transacciones y detalles.
Este documento describe cómo instrumentar la actividad que no está instrumentada por el agente .NET de forma predeterminada. Para conocer otras formas de configurar la instrumentación de su aplicación, consulte Guía para usar la API del agente .NET.
Importante
Para los dos marcos admitidos por el agente (.NET framework y .NET Core), la instrumentación personalizada se realiza de la misma manera, a menos que se indique lo contrario.
Elija un método de instrumentación personalizada
El agente .NET admite dos métodos de instrumentación personalizada:
Método | Descripción |
|---|---|
Ajuste de instrumentación personalizado | Instrumente su código decorando sus métodos con un atributo. La instrumentación de atributos es más sencilla de implementar que la instrumentación XML porque solo necesita agregar un único decorador, en el mismo lugar de su código que el método que desea instrumentar. Para obtener instrucciones, consulte instrumentación personalizada mediante atributo. |
Instrumentación XML personalizada | Instrumente su código enumerando los métodos de destino en un archivo XML. La instrumentación XML es más compleja que la instrumentación de atributos y fallará si cambia el nombre del ensamblado, clase o método que desea instrumentar. Sin embargo, la instrumentación XML no requiere que modifique su código fuente. Para obtener instrucciones, consulte Crear transacción vía XML y Agregar detalles a la transacción vía XML. |
Crear transacción versus agregar detalles
Cuando agrega instrumentación personalizada mediante cualquiera de los métodos, debe elegir entre crear una nueva transacción o agregar instrumentación a una transacción existente:
Situación | Recomendación |
|---|---|
El método que desea tocar no aparece en la UI de New Relic en absoluto | Create a new transaction. Para más detalles, consulte: |
La transacción aparece en la UI de New Relic pero contiene secciones de tiempo no instrumentadas. | Add detail to an existing transaction. Para más detalles, consulte: |
Clasificar como "web" o "no web" (solo método de atributo)
APM separa transacción en transacción web y transacción no web en la UI. Cuando agrega detalles a una transacción existente, su categoría está determinada por la categoría de la transacción principal.
Cuando crea una transacción mediante instrumentación personalizada utilizando el método de atributo, debe categorizarla como web o non-web. (Esto no es posible con la instrumentación XML; todas las transacciones creadas en XML se clasifican como non-web.)
Categoría | Cuándo usar |
|---|---|
Web | Utilice web para solicitudes web. Solo puede marcar una nueva transacción como transacción web con instrumentación personalizada usando atributo, no usando XML. |
No web | Utilice non-web para otros tipos de solicitudes en segundo plano, como aplicaciones y servicios de consola.
|