Este documento explica cómo instalar el agente .NET de New Relic para monitoreo del rendimiento de aplicaciones (APM) en su aplicación web de Azure. (Esto no es lo mismo que instalar la integración de monitoreo de infraestructura para Microsoft Azure). Recommendation: Antes de seguir estas instrucciones, lea la descripción general de la instalación del agente .NET.
Opciones de instalación
Utilice cualquiera de los siguientes métodos para agregar el agente New Relic .NET a su aplicación web Azure-desplegar. La mejor opción depende de tu rol, entorno, despliegue, etc. Por ejemplo:
Para los equipos de operaciones que necesitan monitor la aplicación, la opción más fácil y confiable es usar la extensión del sitio de Azure mantenida públicamente.
Note: Actualmente, las extensiones de sitio de Azure solo están disponibles para los recursos de Windows App Service.
Para los equipos de desarrolladores o cualquier persona que necesite implementar el agente en un recurso de servicio de aplicaciones de Linux, la mejor opción es instalar mediante nuget:
Para monitor aplicaciones que no son web (incluidos WebJobs) o aplicaciones ASP..NET Core orientadas a .NET framework, debe habilitar explícitamente el agente para el proceso .exe
de esa aplicación a través de uno de estos dos métodos:
- Habilitar mediante la colocación del archivo
newrelic.config
local. - Habilitar a través del archivo de configuración de la aplicación
Además, los WebJobs pueden necesitar instrumentación personalizada para que las transacciones aparezcan en APM y configuración adicional si se ejecutan durante menos de un minuto.
Desactivar aplicación información valiosa
Tanto el agente .NET de New Relic como la aplicación de información valiosa de Microsoft dependen del generador de perfiles CLR, pero sólo uno puede estar activo a la vez. must Deshabilita la aplicación información valiosa para que el agente .NET funcione correctamente. Para obtener más información, consulte nuestra aplicación información valiosa sobre procedimientos de resolución de problemas.
Instalar usando la extensión del sitio New Relic Azure (Windows Only)
Para instalar el agente .NET para una aplicación web de Azure mediante la extensión del sitio New Relic Azure:
Cierre su aplicación web antes de instalar New Relic Azure Site Extension.
Agregue la extensión del sitio: navegue hasta
https://[yoursitename].scm.azurewebsites.net
y luego seleccioneSite extensions > Gallery
.
Seleccione el plus
icono junto a la extensión del sitio New Relic.
En Azure Portal, agregue la configuración de la aplicación New Relic a su Azure App Service. Esto instala la última versión del agente .NET. Con la versión 10.x, dejamos de admitir .NET framework 4.6.1 y versiones anteriores y .NET Core 3.0 y versiones anteriores (consulte la guía de migración). Si necesita una versión inferior del agente, utilice la variable de entorno
NEWRELIC_AGENT_VERSION_OVERRIDE
. Por ejemplo:NEWRELIC_AGENT_VERSION_OVERRIDE=9.9.0
.Reinicie su aplicación web.
Sugerencia
Si ya instaló la extensión del sitio y configuró la anulación de la versión, pero su aplicación no genera informes, es posible que deba eliminar y reinstalar la extensión del sitio para que se reconozca la variable de entorno y se instale la versión correcta.
Un par de notas relacionadas con este proceso de instalación:
Si necesita agregar un XML de instrumentación personalizada o modificar el archivo base
newrelic.config
, encontrará el agente .NET para .NET framework en%HOME%\NewRelicAgent\Framework
y el agente para .NET Core en%HOME%\NewRelicAgent\Core
.Este método de instalación supervisa la aplicación
all
.NET Core en la instancia de Azure Web Apps. Si desea deshabilitar el monitoreo para una aplicación .NET Core específica, puede hacer cualquiera de estas cosas:
- Deshabilite el agente en un archivo
appsettings.json
. - En un archivo
newrelic.config
ubicado en el directorio raíz de la aplicación, establezcaagentEnabled
enfalse
.
- Deshabilite el agente en un archivo
Actualización del agente con la extensión del sitio New Relic Azure
Para actualizar el agente .NET para una aplicación web de Azure mediante la extensión del sitio New Relic Azure, siga las instrucciones de instalación para:
- Instale la última versión de New Relic Azure Site Extension, que actualiza los archivos del agente a la última versión.
- Reinicie la aplicación web para iniciar el agente actualizado.
Instalar usando NuGet (.NET framework)
El método de instalación de NuGet empaqueta el agente New Relic con su aplicación para que esté disponible para Azure Web App Host.
Los paquetes NuGet de este procedimiento solo admiten el antiguo packages.config
. No admiten el formato PackageReference
actual. Para obtener más información, consulte la documentación de referencia del paquete de Microsoft.
Para soluciones de múltiples proyectos, asegúrese de haber seleccionado el proyecto correcto (por ejemplo, un proyecto de aplicación web específico) antes de instalar el paquete NuGet.
Si está actualizando el agente de .NET framework mediante NuGet, se sobrescribirán todos los cambios que haya realizado en newrelic.config
. Para conservar cualquier cambio, guarde su newrelic.config
fuera de su proyecto y luego restáurelo después de la actualización.
Para instalar el agente .NET en una aplicación web de Azure mediante NuGet:
En Azure Portal, verifique su plataforma Azure (32 bits o 64 bits): en el menú de la barra lateral de Azure, seleccione
App Services > Your Application > Settings > Configuration > General settings
.
Abra su aplicación en Visual Studio e instale el paquete New Relic NuGet ejecutando el comando apropiado desde la consola
32-bit
:
Install-Package NewRelic.Azure.WebSites
64-bit
:
Install-Package NewRelic.Azure.WebSites.x64
Publica tu aplicación.
En Azure Portal, abra la aplicación web que desea monitor y luego seleccione
Settings > Configuration
.
Desde
Configuration
, seleccione
+ New application setting
y agregue estos pares de valores principales.
Importante
Todos estos ejemplos suponen que su aplicación web de Azure utiliza una raíz del sistema de archivos D:
. Si su Web de Azure usa una raíz C:
, debe usar la letra de unidad correcta al configurar estas rutas.
Llave | Valor |
---|---|
|
|
|
|
|
|
|
|
- En Azure Portal, agregue la configuración de la aplicación New Relic a su Azure App Service.
- Reinicie su aplicación web.
Instalar usando NuGet (.NET Core)
El método de instalación de NuGet empaqueta el agente New Relic con su aplicación para que esté disponible para Azure Web App Host.
Nuestro agente .NET admite la aplicación .NET Core Linux y Windows en Azure App Services. El proceso de instalación de Azure App Services difiere de los procedimientos de instalación del agente .NET para Linux y Windows.
Para instalar el agente .NET en una aplicación web de Azure mediante NuGet:
Instale el paquete
NewRelic.Agent
NuGet.Modifique el nodo log agregando un atributo de directorio a su archivo
newrelic.config
(Note: Si Visual Studio le impide editar el archivonewrelic.config
que NuGet agregó a su proyecto, deberá realizar una copia local de esto en su aplicación):Publica tu aplicación.
En Azure Portal, abra la aplicación web que desea monitor y luego seleccione Settings > Configuration.
Desde Configuration, seleccione + New application setting y agregue estos pares de valores principales.
Importante
Todos estos ejemplos suponen que su aplicación web de Azure utiliza una raíz del sistema de archivos D:
. Si su Web de Azure usa una raíz C:
, debe usar la letra de unidad correcta al configurar estas rutas.
- En Azure Portal, agregue la configuración de la aplicación New Relic a su Azure App Service.
- Reinicie su aplicación web.
Agregar la configuración de la aplicación New Relic a Azure App Services
Para agregar la configuración de su aplicación:
Asegúrese de tener su antes de agregar la configuración de la aplicación del agente New Relic .NET.
En Azure Portal, busque y abra App Services para ir a la aplicación web que desea monitor. A continuación, seleccione Configuration > Application settings.
Desde Application settings, seleccione + New application setting y agregue estos pares de valores principales:
Llave
Valor
NEW_RELIC_LICENSE_KEY
YOUR_LICENSE_KEY
NEW_RELIC_APP_NAME
YOUR_APP_NAME
Si necesita utilizar una versión anterior del agente .NET, utilice este par principal de valor:
Llave
Valor
NEWRELIC_AGENT_VERSION_OVERRIDE
DESIRED_AGENT_VERSION_NUMBER
Guarde y reinicie su aplicación web.
Configurar el y el nombre de la aplicación con Application settings anulará el newrelic.config
.
Para verificar las variables de entorno de su aplicación en la consola de diagnóstico Kudu de su aplicación, vaya a Environment > Environment variables.
Por ejemplo:
https://myappname.scm.azurewebsites.net/Env.cshtml#envVariables
Ver el rendimiento de tu aplicación
Su aplicación debe recibir tráfico para que pueda ver su rendimiento en New Relic. Es posible que tengas que esperar unos minutos para que empiecen a aparecer los datos. Si no aparecen datos, consulte los procedimientos de resolución de problemas para Azure Web Apps. Para ver el rendimiento de su aplicación en New Relic: vaya a one.newrelic.com > All capabilities > APM & services > (select an app). La página APM Summary aparece automáticamente.
¿Te ha ayudado este documento con la instalación?
Resolución de problemas
Si no aparecen datos después de instalar el agente, generar tráfico para su aplicación y esperar unos minutos, pruebe estos consejos de resolución de problemas:
- Asegúrese de que todos los archivos en el directorio
newrelic
en la raíz de su aplicación se hayan publicado en Azure. - Asegúrese de que las variables de entorno estén configuradas correctamente.
- Asegúrese de que Microsoft aplicación información valiosa no esté instalada y configurada en la aplicación. Para obtener más información, consulte la aplicación información valiosa sobre procedimientos de resolución de problemas.
- Consulte los procedimientos adicionales de resolución de problemas de Azure según corresponda.