Instalar el agente .NET en Azure servicios en la nube

Este documento explica cómo instalar el agente .NET de APM en la plataforma de servicios en la nube Azure de Microsoft. Esto no es lo mismo que instalar la integración de infraestructura para Microsoft Azure. Para asegurarse de que está utilizando las instrucciones más relevantes, primero consulte la instalación del agente .NET.

Verifique la ubicación del rol web o de trabajador

Si Service archivos están anidados dentro de una carpeta Solution , el instalador de NuGet no puede localizar ni actualizar los archivos necesarios. Esto causará problemas con la configuración del agente .NET, lo que a su vez evitará que el agente informe métricamente sobre sus servicios en la nube.

Recommendation: Coloque el rol Web o Worker en el root de la solución antes de instalar el paquete NuGet. Una vez que el agente New Relic .NET esté instalado, puede volver a mover la función de nube a la carpeta Solution .

Instale el paquete NuGet para servicios en la nube

Para soluciones de múltiples proyectos, asegúrese de haber seleccionado el proyecto correcto (por ejemplo, un proyecto de sitio web específico) antes de instalar el paquete NuGet.

1. Abra su solución de Visual Studio o cree una nueva seleccionando

   File > New > Project

   . Para soluciones de múltiples proyectos, asegúrese de haber seleccionado el proyecto correcto (por ejemplo, un proyecto de sitio web específico).

2. Si aún no tiene un proyecto de servicios en la nube de Azure en su solución, agregue uno haciendo clic derecho en su aplicación en

   Solution Explorer

   y seleccionando

   Add Windows Azure Cloud Service Project

   .

3. Abra la consola

   Package Manager

   seleccionando

   Tools > Library Package Manager > Package Manager Console

   . Configure su proyecto como el proyecto predeterminado.

4. Desde el símbolo del sistema

   Package Manager

   , escriba Install-Package NewRelicWindowsAzure y presione

   Enter

   .

5. Siga el símbolo para ingresar su clave de licencia de New Relic y el nombre de su aplicación como desea que aparezca en la UI de New Relic. O utilice el nombre de su solución como nombre predeterminado de la aplicación.

6. Desde

   Solution Explorer

   , haga clic con el botón derecho en su proyecto de servicios en la nube de Azure y seleccione

   Publish

   .

7. Si es la primera vez que implementa esta aplicación en Azure, ingrese sus credenciales de Azure.

8. Si corresponde, métodos de instrumento para Worker roles.

Rol del Instrument Worker

Un rol Worker es un proceso no web que se ejecuta como servicios de Azure en la nube. Para instrumentar un rol Worker , debe crear una transacción personalizada.

El agente .NET instrumenta automáticamente llamadas externas y llamadas de base de datos, pero no instrumenta métodos predeterminados para la transacción. Creando transacciones personalizadas se soluciona esto. Después de que se inicie la función Worker y se ejecute el método, los datos de la transacción aparecerán en las páginas APM Summary y Transactions en la categoríaNon-web .

El instalador de NuGet agrega automáticamente el parámetro NewRelic.AppName a la configuración de la aplicación. Esto aparece como <YOUR_WORKER_ROLE_NAME>.dll.config en E:\approot.

El agente .NET también instrumentó automáticamente WaWorkerHost.exe. Este es el nombre del proceso de rol Worker real.

namespace MyWorkerRole
{
    public class NotificationQueue
    {
        public bool ProcessMessage(Message message) {
            // code to process message
        }
    }
}

<?xml version="1.0" encoding="utf-8"?>
<extension xmlns="urn:newrelic-extension">
  <instrumentation>
    <tracerfactory name="NewRelic.Agent.Core.Tracer.Factories.BackgroundThreadTracerFactory" metricName="Custom/ProcessMessage">
      <match assemblyname="MyWorkerRole" classname="MyWorkerRole.NotificationQueue">
        <exactmethodmatcher methodName="ProcessMessage" />
      </match>
    </tracerfactory>
  </instrumentation>
</extension>

Opcional: crear un archivo de configuración personalizado

Puede crear un archivo de configuración personalizado en Visual Studio. Esto le permite realizar cambios en newrelic.config dentro de Visual Studio, sin tener que acceder de forma remota a su instancia de rol de Azure cada vez que realiza un cambio. Cada vez que publica su aplicación, el archivo de configuración en Visual Studio se carga automáticamente en el host remoto.

Las elecciones que haga con el asistente de instalación no importan. La instalación local no afecta su entorno de desarrollo de Azure.

1. En Visual Studio, seleccione Solution Explorer y luego abra NewRelicAgent_x64_XYZ.msi.

2. Siga los pasos para instalar el agente localmente.

3. Importe newrelic.config a su proyecto: en Solution Explorer > Cloud Project, haga clic derecho en Web Role y luego seleccione Add > Existing Item. Navegue hasta C:\ProgramData\New Relic\.NET Agent y seleccione newrelic.config.

4. Desde C:\ProgramData\New Relic\.NET Agent, edite newrelic.cmd.

5. En la sección :INSTALL_NEWRELIC_AGENT , busque esta declaración:

   IF $ERRORLEVEL% EQU 0 (

   Copia

6. Agregue el siguiente código como otra declaración dentro del bloque IF y luego guarde el archivo:

   copy /Y "%RoleRoot%\approot\newrelic.config" "%NR_HOME%" >> %RoleRoot%\nr.log

   Copia

Ahora puede editar el newrelic.config alojado en Visual Studio. Siempre que publique su aplicación, el comando copy cargará el archivo de configuración en el host remoto.

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 de Azure servicios en la nube. Para ver el rendimiento de su aplicación en APM: vaya a one.newrelic.com > All capabilities > APM & services > (select an app). La página APM Summary aparece automáticamente.