Abilitare Profiler per le app Web in una macchina virtuale di Azure

Nota

È consigliabile usare il modulo Azure Az PowerShell per interagire con Azure. Per iniziare, vedere Installare Azure PowerShell. Per informazioni su come eseguire la migrazione al modulo AZ PowerShell, vedere Eseguire la migrazione di Azure PowerShell da AzureRM ad Az.

Questo articolo illustra come eseguire Application Insights Profiler nella macchina virtuale di Azure o nel set di scalabilità di macchine virtuali di Azure tramite tre diversi metodi:

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

Selezionare la scheda del metodo preferito per:

Questa guida illustra come eseguire queste operazioni:

• Configurare l'estensione Diagnostica di Azure per eseguire Profiler.
• Installare Application Insights SDK in una macchina virtuale.
• Distribuire l'applicazione.
• Visualizzare le analisi Profiler tramite l'istanza di Application Insights nel portale di Azure.

Prerequisiti

• Un'applicazione ASP.NET Core funzionante.
• Una risorsa di Application Insights.
• Per esaminare i modelli di Azure Resource Manager (modelli di ARM) per l'estensione Diagnostica di Azure:
  • VM
  • Set di scalabilità di macchine virtuali

Aggiungere l'SDK di Application Insights all'applicazione

1. Aprire il progetto di ASP.NET Core in Visual Studio.

2. Selezionare Progetto>Aggiungi Application Insights Telemetry.

3. Selezionare Azure Application Insights>Avanti.

4. Selezionare la sottoscrizione in cui risiede la risorsa di Application Insights e selezionare Avanti.

5. Selezionare dove salvare la stringa di connessione e selezionare Avanti.

6. Selezionare Fine.

Nota

Per istruzioni complete, tra cui come abilitare Application Insights nell'applicazione ASP.NET Core senza Visual Studio, vedere le applicazioni Application Insights per ASP.NET Core.

Verificare la versione stabile più recente di Application Insights SDK

1. Andare a Progetto>Gestisci pacchetti NuGet.

2. Selezionare Microsoft.ApplicationInsights.AspNetCore.

3. Nel riquadro laterale selezionare la versione più recente dell'SDK nell'elenco a discesa.

4. Selezionare Aggiorna.

   

Abilitare Profiler

È possibile abilitare Profiler in uno dei tre modi seguenti:

• All'interno dell'applicazione ASP.NET Core usando un modello di Azure Resource Manager e Visual Studio. Consigliato.
• Usando un comando di PowerShell tramite l'interfaccia della riga di comando di Azure.
• Usando Esplora risorse di Azure.

Visual Studio e modello di ARM

Installare l'estensione Diagnostica di Azure

1. Scegliere il modello di ARM da usare:

   • VM
   • Set di scalabilità di macchine virtuali

2. Nel modello individuare la risorsa di tipo extension.

3. In Visual Studio andare al file arm.json nell'applicazione ASP.NET Core aggiunta quando è stato installato Application Insights SDK.

4. Aggiungere il tipo di risorsa extension dal modello al file arm.json per configurare una macchina virtuale o un set di scalabilità di macchine virtuali con Diagnostica di Azure.

5. All'interno del tag WadCfg aggiungere la chiave di strumentazione di Application Insights a MyApplicationInsightsProfilerSink.

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

6. Distribuire l'applicazione.

PowerShell

I comandi di PowerShell seguenti sono un approccio per le macchine virtuali esistenti che toccano solo l'estensione Diagnostica di Azure.

Nota

Se si distribuisce di nuovo la macchina virtuale, il sink andrà perso. È necessario aggiornare la configurazione usata quando si distribuisce la macchina virtuale per mantenere questa impostazione.

Installare Application Insights tramite la configurazione di Diagnostica di Azure

1. Esportare la configurazione di Diagnostica di Azure attualmente distribuita in un file:

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

2. Aggiungere il sink di Application Insights Profiler alla configurazione restituita dal comando seguente:

   (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. Eseguire il comando seguente per passare la configurazione aggiornata al comando Set-AzVMDiagnosticsExtension.

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

   Nota

   Set-AzVMDiagnosticsExtension potrebbe richiedere l'argomento -StorageAccountName. Se la configurazione di diagnostica originale aveva la proprietà storageAccountName nella sezione protectedSettings (che non è scaricabile), assicurarsi di passare lo stesso valore originale presente in questa chiamata al cmdlet.

Funzionalità di traccia HTTP IIS

Se l'applicazione interessata è in esecuzione tramite IIS, abilitare la funzionalità di Windows IIS Http Tracing:

1. Stabilire l'accesso remoto all'ambiente.

2. Usare la finestra Aggiungi funzionalità di Windows oppure eseguire il comando seguente in PowerShell (come amministratore):

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

   Se non si riesce a stabilire l'accesso remoto, è possibile usare l'interfaccia della riga di comando di Azure per eseguire il comando seguente:

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

3. Distribuire l'applicazione.

Azure Resource Explorer

Impostare il sink del Profiler usando Esplora risorse di Azure

Poiché il portale di Azure non offre un modo per impostare il sink di Application Insights Profiler, è possibile usare Esplora risorse di Azure per impostare il sink.

Nota

Se si distribuisce di nuovo la macchina virtuale, il sink andrà perso. È necessario aggiornare la configurazione usata quando si distribuisce la macchina virtuale per mantenere questa impostazione.

1. Verificare che l'estensione Diagnostica di Microsoft Azure sia installata visualizzando le estensioni installate per la macchina virtuale.

   

2. Trovare l'estensione diagnostica della macchina virtuale per la macchina virtuale:

   1. Andare a Esplora risorse di Azure.

   2. Espandere le sottoscrizioni e trovare la sottoscrizione che contiene il gruppo di risorse con la macchina virtuale.

   3. Eseguire il drill-down nelle estensioni della macchina virtuale selezionando il gruppo di risorse. Selezionare quindi Microsoft.Compute>virtualMachines>[la macchina virtuale]>estensioni.

      

3. Aggiungere il sink di Application Insights Profiler al nodo SinksConfig in WadCfg. Se non si ha già una sezione SinksConfig, potrebbe essere necessario aggiungerne una. Per aggiungere il sink:

   • Specificare l'iKey di Application Insights appropriato nelle impostazioni.

   • Impostare la modalità Esplora risorse su Lettura/Scrittura nell'angolo in alto a destra.

   • Seleziona Modifica

     

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

4. Dopo aver completato la modifica della configurazione, selezionare PUT.

5. Se put ha esito positivo, viene visualizzato un segno di spunta verde al centro dello schermo.

   

È possibile eseguire Profiler nei server locali?

Attualmente, Application Insights Profiler non è supportato per i server locali.

Passaggi successivi

Generare il carico e visualizzare le analisi Profiler