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 metodi diversi:

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

Con uno di questi metodi, è possibile:

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

Prerequisiti

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

Aggiungere Application Insights SDK all'applicazione

1. Aprire il progetto principale ASP.NET in Visual Studio.

2. Selezionare Project>Add Application Insights Telemetry (Aggiungi dati di telemetria di Application Insights).

3. Selezionare applicazione Azure 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 Application Insights per ASP.NET Core applicazioni.

Verificare la versione stabile più recente di Application Insights SDK

1. Passare a Project>Manage NuGet Packages (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 tre modi:

• 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.

Modello di Visual Studio e ARM

Installare l'estensione Diagnostica di Azure

1. Scegliere il modello di Resource Manager da usare:

   • VM
   • Set di scalabilità di macchine virtuali

2. Nel modello individuare la risorsa di tipo extension.

3. In Visual Studio passare al file nell'applicazione arm.json ASP.NET Core aggiunta durante l'installazione di Application Insights SDK.

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

5. All'interno del WadCfg tag 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 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 Set-AzVMDiagnosticsExtension comando .

   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 storageAccountName proprietà nella protectedSettings sezione (che non è scaricabile), assicurarsi di passare lo stesso valore originale presente in questa chiamata al cmdlet.

Funzionalità di traccia HTTP IIS

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

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 Azure Resource Explorer

Poiché il portale di Azure non fornisce un modo per impostare il sink del profiler di Application Insights, è 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 Microsoft Diagnostica di Azure sia installata visualizzando le estensioni installate per la macchina virtuale.

   

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

   1. Passare 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 delle estensioni della macchina virtuale selezionando il gruppo di risorse. Selezionare quindi Microsoft.Compute>virtualMachines>[your virtual machine]>extensions.

      

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

   • Specificare la chiave iKey di Application Insights appropriata nelle impostazioni.

   • Impostare la modalità Esplora risorse su Lettura/Scrittura nell'angolo superiore destro.

   • Selezionare Modifica.

     

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

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

5. Se l'oggetto put ha esito positivo, al centro della schermata viene visualizzato un segno di spunta verde.

   

È possibile eseguire Profiler nei server locali?

Application Insights Profiler non è attualmente supportato per i server locali.

Passaggi successivi

Generare tracce del profiler di caricamento e visualizzazione