El agente .NET de New Relic incluye una API que le permite ampliar la funcionalidad estándar del agente. Por ejemplo, puede utilizar la API del agente .NET para:
- Personalizando el nombre de tu aplicación
- Crear parámetro de transacción personalizado
- Reporte de errores personalizados y métricos.
También puede personalizar parte del comportamiento predeterminado del agente .NET ajustando la configuración o utilizando instrumentación personalizada.
Requisitos
Importante
A partir de septiembre de 2021, un pequeño subconjunto de API, opciones de configuración y opciones de instalación para .NET será reemplazado por nuevos métodos. Para obtener más detalles, incluido cómo prepararse fácilmente para esta transición, consulte nuestra publicación en el Foro de soporte.
Para utilizar la API del agente .NET:
Asegúrese de tener la última versión del agente .NET.
Agregue una referencia al agente en su proyecto:
Añade una referencia a
NewRelic.Api.Agent.dll
a tu proyecto.O
Vea y descargue el paquete API desde la biblioteca de paquetes NuGet.
Instrumento faltan secciones de tu código con transacción.
Para instrumentar su aplicación, New Relic separa cada ruta a través de su código en su propia transacción. New Relic mide (o "instrumentado") el método principal en estas transacciones para medir el rendimiento general de su aplicación y recopila la traza de la transacción de transacciones de larga duración para obtener detalles adicionales.
Utilice estos métodos cuando New Relic no esté instrumentada en absoluto en una parte particular de su código:
Si quieres... | Hacer esto... |
---|---|
Evitar que una transacción se informe a New Relic | Utilice |
Crear una transacción donde no existe ninguna | Utilice un atributo o un archivo XML para crear una nueva transacción. |
Métodos específicos de tiempo que utilizan segmentos
Si una transacción ya es visible en la UI de New Relic, pero no tiene suficientes datos sobre un método en particular que se llamó durante esa transacción, puede crear segmentos para cronometrar esos métodos individuales con mayor detalle. Por ejemplo, es posible que desee cronometrar un método particularmente crítico con lógica compleja.
Cuando desee instrumentar un método dentro de una transacción existente, consulte instrumentación personalizada vía atributo o Agregar detalle a transacciones vía XML.
Mejorar los metadatos de una transacción
A veces, el código al que se dirige es visible en la UI de New Relic, pero algunos detalles del método no son útiles. Por ejemplo:
- Es posible que el nombre predeterminado no resulte útil. (Quizás esté causando un problema de agrupación métrica).
- Quieres agregar atributos personalizados a tu transacción para poder filtrarlos en el tablero.
Utilice estos métodos cuando desee cambiar la forma en que New Relic instrumentó una transacción que ya está visible en la UI de New Relic:
Si quieres... | Hacer esto... |
---|---|
Cambiar el nombre de una transacción | Utilice |
Evite que una transacción afecte su puntuación Apdex | Utilice |
Agregue metadatos (como el nombre de la cuenta de sus clientes o el nivel de suscripción) a su transacción | Utilice un atributo personalizado. Ver |
Ver registro relacionado
Para ver el registro directamente dentro del contexto de los errores y la traza de su aplicación, use estas llamadas API para anotar su registro:
Para obtener más información sobre cómo correlacionar los datos log con otros telemetry data, consulte nuestra documentación de contexto de registro .
Trabajo asincrónico del instrumento.
Para el marco compatible, el agente .NET generalmente detecta el trabajo asíncrono y lo instrumenta correctamente. Sin embargo, si su aplicación usa otro framework o la instrumentación asíncrona predeterminada no es precisa, puede conectar explícitamente el trabajo asíncrono.
Si quieres... | Hacer esto... |
---|---|
Traza un método asíncrono que New Relic ya está instrumentado | Utilice un archivo XML para implementar métodos asíncronos en aplicaciones IIS. Para obtener consejos sobre resolución de problemas, consulte falta async métrica. |
Traza un método asíncrono que New Relic no está instrumentado | Utilice un archivo XML para implementar métodos asíncronos en aplicaciones IIS. Para obtener consejos sobre resolución de problemas, consulte falta async métrica. |
Ver llamadas a servicios externos
Para la versión 8.9 o superior del agente .NET, puede utilizar las siguientes API de carga útil de rastreo distribuido para pasar manualmente el contexto de rastreo distribuido entre los servicios de New Relic-monitor que no se conectan automáticamente entre sí en un rastreo distribuido.
Si quieres... | Hacer esto... |
---|---|
Instrumento una solicitud saliente a una aplicación o base de datos externa. | Agregue una carga útil de rastreo distribuido a una solicitud saliente usando |
Conecte las solicitudes entrantes con el originador de la solicitud para completar un tramo de la traza. | Reciba una carga útil en una solicitud entrante usando |
Para versiones del agente .NET inferiores a 8.9, utilice el seguimiento de aplicaciones múltiples.
Cobro o error omitido
Normalmente el agente .NET detecta errores automáticamente. Sin embargo, puede marcar manualmente un error con el agente. También puedes cometer un error omitido .
Si quieres... | Hacer esto... |
---|---|
Informar un error que el agente .NET no informa automáticamente | Utilice |
Capture errores o evite que el agente .NET informe un error | Utilice su archivo de configuración del agente .NET. |
Envía datos de eventos personalizados y métricos desde tu app
APM incluye varias formas de registrar datos personalizados arbitrarios. Para obtener una explicación de los tipos de datos de New Relic, consulte Recopilación de datos.
Si quieres... | Hacer esto... |
---|---|
Envía datos sobre un evento para que puedas analizarlo en el panel | Crea un evento personalizado. Ver |
etiquete su evento con metadatos para filtrarlos y facetarlos en el panel o análisis de errores | Agregue un atributo personalizado. Consulte Atributo del agente .NET y Habilitar y deshabilitar atributo. |
Informar datos de rendimiento personalizados | Utilice |
Controlar el monitoreo del agente navegador
Por lo general, el agente se agrega automáticamente a sus páginas o se implementa copiando y pegando el fragmento de JavaScript. Para obtener más información sobre estos métodos recomendados, consulte Agregar aplicaciones al monitoreo del navegador.
Sin embargo, también puede controlar el agente del navegador a través de la API de llamada del agente APM. Para obtener más información, consulte monitoreo del navegador y el agente .NET.