.NET Profiler inschakelen voor web-apps op een virtuele Azure-machine

Notitie

Het wordt aanbevolen de Azure Az PowerShell-module te gebruiken om te communiceren met Azure. Zie Azure PowerShell installeren om aan de slag te gaan. Raadpleeg Azure PowerShell migreren van AzureRM naar Az om te leren hoe u naar de Azure PowerShell-module migreert.

In dit artikel leert u hoe u Application Insights Profiler voor .NET uitvoert op uw virtuele Azure-machine (VM) of virtuele-machineschaalset van Azure via drie verschillende methoden:

• Visual Studio en Azure Resource Manager
• Powershell
• Azure Resource Explorer

Selecteer het tabblad Methode van uw voorkeur om het volgende te doen:

In deze handleiding leert u het volgende:

• Configureer de Azure Diagnostics-extensie om de .NET Profiler uit te voeren.
• Installeer de Application Insights SDK op een virtuele machine.
• Implementeer uw toepassing.
• Profiler-traceringen weergeven via het Application Insights-exemplaar in Azure Portal.

Vereisten

• Een werkende ASP.NET Core-toepassing.
• Een Application Insights-resource.
• De Azure Resource Manager-sjablonen (ARM-sjablonen) voor de Azure Diagnostics-extensie bekijken:
  • VM
  • Virtuele-machineschaalset

De Application Insights-SDK toevoegen aan uw toepassing

1. Open uw ASP.NET kernproject in Visual Studio.

2. Selecteer Application Insights-telemetrie toevoegen in Project>.

3. Selecteer Azure-toepassing Insights>Next.

4. Selecteer het abonnement waarin uw Application Insights-resource zich bevindt en selecteer Volgende.

5. Selecteer waar u de verbindingsreeks wilt opslaan en selecteer Volgende.

6. Klik op Voltooien.

Notitie

Zie de Application Insights voor ASP.NET Core-toepassingen voor volledige instructies, waaronder het inschakelen van Application Insights voor uw ASP.NET Core-toepassing zonder Visual Studio.

Bevestig de nieuwste stabiele release van de Application Insights SDK

1. Ga naar NuGet-pakketten beheren in Project>.

2. Selecteer Microsoft.ApplicationInsights.AspNetCore.

3. Selecteer in het zijvenster de nieuwste versie van de SDK in de vervolgkeuzelijst.

4. Selecteer Bijwerken.

   

.NET Profiler inschakelen

U kunt Profiler op drie manieren inschakelen:

• Binnen uw ASP.NET Core-toepassing met behulp van een Azure Resource Manager-sjabloon en Visual Studio. Aanbevolen.
• Met behulp van een PowerShell-opdracht via de Azure CLI.
• Met behulp van Azure Resource Explorer.

Visual Studio en ARM-sjabloon

De diagnostische Azure-extensie installeren

1. Kies welke ARM-sjabloon u wilt gebruiken:

   • VM
   • Virtuele-machineschaalset

2. Zoek in de sjabloon de resource van het type extension.

3. Ga in Visual Studio naar het arm.json bestand in uw ASP.NET Core-toepassing die is toegevoegd toen u de Application Insights SDK hebt geïnstalleerd.

4. Voeg het resourcetype extension van de sjabloon toe aan het arm.json bestand om een VIRTUELE machine of virtuele-machineschaalset in te stellen met Azure Diagnostics.

5. Voeg binnen de WadCfg tag uw Application Insights-instrumentatiesleutel toe aan MyApplicationInsightsProfilerSink.

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

6. Implementeer uw toepassing.

Powershell

De volgende PowerShell-opdrachten zijn een benadering voor bestaande VM's die alleen de Azure Diagnostics-extensie aanraken.

Notitie

Als u de virtuele machine opnieuw implementeert, gaat de sink verloren. U moet de configuratie bijwerken die u gebruikt wanneer u de VIRTUELE machine implementeert om deze instelling te behouden.

Application Insights installeren via de Azure Diagnostics-configuratie

1. Exporteer de momenteel geïmplementeerde Azure Diagnostics-configuratie naar een bestand:

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

2. Voeg de Application Insights Profiler-sink toe aan de configuratie die wordt geretourneerd door de volgende opdracht:

   (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. Voer de volgende opdracht uit om de bijgewerkte configuratie door te geven aan de Set-AzVMDiagnosticsExtension opdracht.

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

   Notitie

   Set-AzVMDiagnosticsExtension kan het -StorageAccountName argument vereisen. Als de oorspronkelijke diagnostische configuratie de storageAccountName eigenschap in de protectedSettings sectie had (die niet kan worden gedownload), moet u dezelfde oorspronkelijke waarde doorgeven die u in deze cmdlet-aanroep had.

IIS Http Tracing-functie

Als de beoogde toepassing wordt uitgevoerd via IIS, schakelt u de IIS Http Tracing Windows-functie in:

1. Externe toegang tot de omgeving tot stand brengen.

2. Gebruik het venster Windows-onderdelen toevoegen of voer de volgende opdracht uit in PowerShell (als beheerder):

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

   Als het tot stand brengen van externe toegang een probleem is, kunt u de Azure CLI gebruiken om de volgende opdracht uit te voeren:

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

3. Implementeer uw toepassing.

Azure Resource Explorer

De Profiler-sink instellen met behulp van Azure Resource Explorer

Omdat Azure Portal geen manier biedt om de Application Insights Profiler voor .NET-sink in te stellen, kunt u Azure Resource Explorer gebruiken om de sink in te stellen.

Notitie

Als u de virtuele machine opnieuw implementeert, gaat de sink verloren. U moet de configuratie bijwerken die u gebruikt wanneer u de VIRTUELE machine implementeert om deze instelling te behouden.

1. Controleer of de Microsoft Azure Diagnostics-extensie is geïnstalleerd door de extensies weer te geven die voor uw virtuele machine zijn geïnstalleerd.

   

2. Zoek de diagnostische extensie voor de VM voor uw VM:

   1. Ga naar Azure Resource Explorer.

   2. Vouw abonnementen uit en zoek het abonnement met de resourcegroep met uw VIRTUELE machine.

   3. Zoom in op uw VM-extensies door uw resourcegroep te selecteren. Selecteer vervolgens Extensies voor Microsoft.Compute>virtualMachines>[uw virtuele machine].>

      

3. Voeg de Application Insights Profiler voor .NET-sink toe aan het SinksConfig knooppunt onder WadCfg. Als u nog geen sectie hebt, moet u er mogelijk een SinksConfig toevoegen. Ga als volgende te werk om de sink toe te voegen:

   • Geef de juiste Application Insights iKey op in uw instellingen.

   • Zet de Verkenner-modus op Lezen/Schrijven in de rechterbovenhoek.

   • Selecteer Bewerken.

     

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

4. Nadat u klaar bent met het bewerken van de configuratie, selecteert u PUT.

5. Als het put lukt, wordt er een groen vinkje weergegeven in het midden van het scherm.

   

Kan de .NET Profiler worden uitgevoerd op on-premises servers?

Momenteel wordt Application Insights Profiler voor .NET niet ondersteund voor on-premises servers.

Volgende stappen

.NET Profiler-traceringen genereren en weergeven