Habilitación de Profiler para .NET para aplicaciones web en una máquina virtual de Azure

Nota:

Se recomienda usar el módulo Azure Az de PowerShell para interactuar con Azure. Para comenzar, consulte Instalación de Azure PowerShell. Para más información sobre cómo migrar al módulo Az de PowerShell, consulte Migración de Azure PowerShell de AzureRM a Az.

En este artículo, aprenderá a ejecutar Application Insights Profiler para .NET en la máquina virtual (VM) de Azure o en el conjunto de escalado de máquinas virtuales de Azure mediante tres métodos diferentes:

• Visual Studio y Azure Resource Manager
• PowerShell
• Azure Resource Explorer

Seleccione la pestaña método preferido para:

En esta guía, aprenderá a:

• Configure la extensión de Azure Diagnostics para ejecutar Profiler para .NET.
• Instale el SDK de Application Insights en una máquina virtual.
• Implementación de aplicación.
• Vea seguimientos de Profiler mediante la instancia de Application Insights en Azure Portal.

Requisitos previos

• Una aplicación de ASP.NET Core en funcionamiento.
• Un recurso de Application Insights.
• Para revisar las plantillas de Azure Resource Manager (plantillas de ARM) para la extensión Azure Diagnostics:
  • VM
  • Conjunto de escalado de máquinas virtuales

Agregar el SDK de Application Insights a la aplicación

1. Abra el proyecto de ASP.NET Core en Visual Studio.

2. Seleccione Proyecto>Agregar Telemetría de Application Insights.

3. Seleccione Aplicación de Azure Insights>Siguiente.

4. Seleccione la suscripción donde reside el recurso de Application Insights y seleccione Siguiente.

5. Seleccione dónde guardar la cadena de conexión y seleccione Siguiente.

6. Seleccione Finalizar.

Nota

Para obtener instrucciones completas, incluido cómo habilitar Application Insights en la aplicación de ASP.NET Core sin Visual Studio, consulte Application Insights para aplicaciones de ASP.NET Core.

Confirmar la versión estable más reciente del SDK de Application Insights

1. Vaya a Proyecto>Administrar paquetes NuGet.

2. Seleccione Microsoft.ApplicationInsights.AspNetCore.

3. En el panel lateral, seleccione la versión más reciente del SDK en la lista desplegable.

4. Selecciona Actualización.

   

Habilitación de Profiler para .NET

Puede habilitar Profiler de tres maneras:

• Dentro de la aplicación de ASP.NET Core mediante una plantilla de Azure Resource Manager y Visual Studio. Opción recomendada.
• Uso de un comando de PowerShell mediante la CLI de Azure.
• Mediante Azure Resource Explorer.

Plantilla de Visual Studio y ARM

Instalación de la extensión Azure Diagnostics

1. Elija la plantilla de ARM que se va a usar:

   • VM
   • Conjunto de escalado de máquinas virtuales

2. En la plantilla, busque el recurso de tipo extension.

3. En Visual Studio, vaya al archivo arm.json de la aplicación de ASP.NET Core que se agregó al instalar el SDK de Application Insights.

4. Agregue el tipo extension de recurso de la plantilla al arm.json archivo para configurar una máquina virtual o un conjunto de escalado de máquinas virtuales con Azure Diagnostics.

5. Dentro de la etiqueta WadCfg, agregue la clave de instrumentación de Application Insights a MyApplicationInsightsProfilerSink.

   "WadCfg": {
     "SinksConfig": {
       "Sink": [
         {
           "name": "MyApplicationInsightsProfilerSink",
           "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
         }
       ]
     }
   }        
   

6. Implementación de aplicación.

PowerShell

Los siguientes comandos de PowerShell se pueden usar como un enfoque para las máquinas virtuales existentes que solo afecta a la extensión de Azure Diagnostics.

Nota

Si vuelve a implementar la máquina virtual, el receptor se perderá. Debe actualizar la configuración que usa al implementar la máquina virtual para conservar este ajuste.

Instalación de Application Insights mediante la configuración de Azure Diagnostics

1. Exporte la configuración de Azure Diagnostics implementada actualmente en un archivo:

   $ConfigFilePath = [IO.Path]::GetTempFileName()
   

2. Agregue el receptor de Application Insights Profiler a la configuración devuelta por el siguiente comando:

   (Get-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM").PublicSettings | Out-File -Verbose $ConfigFilePath
   

   Application Insights Profiler WadCfg:

   "WadCfg": {
     "SinksConfig": {
       "Sink": [
         {
           "name": "MyApplicationInsightsProfilerSink",
           "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
         }
       ]
     }
   }        
   

3. Ejecute el siguiente comando para pasar la configuración actualizada al comando Set-AzVMDiagnosticsExtension.

   Set-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM" -DiagnosticsConfigurationPath $ConfigFilePath
   

   Nota

   Set-AzVMDiagnosticsExtension puede requerir el argumento -StorageAccountName. Si la configuración de diagnóstico original tenía la propiedad storageAccountName en la sección protectedSettings (que no se puede descargar), asegúrese de pasar el mismo valor original que tenía en esta llamada de cmdlet.

Característica de seguimiento http de IIS

Si la aplicación deseada se ejecuta mediante IIS, habilite la característica IIS Http Tracing de Windows:

1. Establezca el acceso remoto al entorno.

2. Use la ventana Agregar características de Windows o ejecute el siguiente comando en PowerShell (como administrador):

   Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All
   

   Si el establecimiento del acceso remoto supone un problema, puede usar la CLI de Azure para ejecutar el siguiente comando:

   az vm run-command invoke -g MyResourceGroupName -n MyVirtualMachineName --command-id RunPowerShellScript --scripts "Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All"
   

3. Implementación de aplicación.

Azure Resource Explorer

Establecimiento del receptor de Profiler con Azure Resource Explorer

Dado que Azure Portal no proporciona una manera de establecer el receptor de Application Insights Profiler para .NET, puede usar Azure Resource Explorer para establecer el receptor.

Nota:

Si vuelve a implementar la máquina virtual, el receptor se perderá. Debe actualizar la configuración que usa al implementar la máquina virtual para conservar este ajuste.

1. Compruebe que la extensión de Windows Azure Diagnostics esté instalada. Para ello, revise las extensiones instaladas para la máquina virtual.

   

2. Busque la extensión de diagnóstico de VM para su máquina virtual:

   1. Vaya a Azure Resource Explorer.

   2. Expanda suscripciones y busque la suscripción que contiene el grupo de recursos con la máquina virtual.

   3. Explore en profundidad las extensiones de la máquina virtual seleccionando el grupo de recursos. A continuación, seleccione Microsoft.Compute>virtualMachines>[su máquina virtual]>extensiones.

      

3. Agregue el receptor de Application Insights Profiler para .NET al nodo SinksConfig en WadCfg. Si todavía no tiene una sección SinksConfig, es posible que tenga que agregar una. Para agregar el receptor:

   • Especifique la iKey de Application Insights correspondiente en la configuración.

   • Cambie el modo de Explorer a Lectura/Escritura en la esquina superior derecha.

   • Seleccione Editar.

     

     "WadCfg": {
       "SinksConfig": {
         "Sink": [
           {
             "name": "MyApplicationInsightsProfilerSink",
             "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
           }
         ]
       }
     }        
     

4. Cuando haya terminado de editar la configuración, seleccione PUT.

5. Si put se realiza correctamente, aparece una marca verde en medio de la pantalla.

   

¿Puede ejecutarse Profiler para .NET en servidores locales?

Actualmente, Application Insights Profiler para .NET no es compatible con servidores locales.

Pasos siguientes

Generación de carga y visualización de seguimientos de Profiler para .NET