Aktivieren des .NET-Profilers für Web-Apps auf einer Azure-VM

Installieren der Azure-Diagnoseerweiterung

1. Wählen Sie die zu verwendende ARM-Vorlage:

   • VM
   • VM-Skalierungsgruppe

2. Suchen Sie in der Vorlage die Ressource mit dem Typ extension.

3. Wechseln Sie in Visual Studio zur Datei arm.json in Ihrer ASP.NET Core-Anwendung, die bei der Installation des Application Insights SDK hinzugefügt wurde.

4. Fügen Sie den Ressourcentyp extension aus der Vorlage zur Datei arm.json hinzu, um eine VM oder VM-Skalierungsgruppe mit Azure-Diagnose einzurichten.

5. Fügen Sie innerhalb des Tags WadCfg Ihren Application Insights-Instrumentierungsschlüssel zu MyApplicationInsightsProfilerSink hinzu.

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

6. Stellen Sie Ihre Anwendung bereit.

Die folgenden PowerShell-Befehle sind ein Ansatz für vorhandene virtuelle VMs und betreffen nur die Erweiterung „Azure-Diagnose“.

Installieren von Application Insights über die Azure-Diagnose-Konfiguration

1. Exportieren Sie die aktuell bereitgestellte Konfiguration der Azure-Diagnose in eine Datei:

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

2. Fügen Sie die Senke „Application Insights Profiler“ zu der mit dem folgenden Befehl zurückgegebenen Konfiguration hinzu:

   (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. Führen Sie den folgenden Befehl aus, um die aktualisierte Konfiguration an den Befehl Set-AzVMDiagnosticsExtension zu übergeben.

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

   Hinweis

   Set-AzVMDiagnosticsExtension benötigt möglicherweise das Argument -StorageAccountName. Wenn Ihre ursprüngliche Diagnosekonfiguration die Eigenschaft storageAccountName im Abschnitt protectedSettings enthielt (die nicht heruntergeladen werden kann), stellen Sie sicher, dass Sie in diesem Aufruf des Cmdlets denselben ursprünglichen Wert übergeben.

IIS-Feature „HTTP-Ablaufverfolgung“

Wenn die betroffene Anwendung über IIS ausgeführt wird, aktivieren Sie das Windows-Feature IIS Http Tracing:

1. Richten Sie einen Remotezugriff auf die Umgebung ein.

2. Verwenden Sie dann das Fenster Windows-Features hinzufügen, oder führen Sie den folgenden Befehl in PowerShell (als Administrator) aus:

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

   Wenn das Einrichten des Remotezugriffs ein Problem darstellt, können Sie folgenden Befehl über die Azure-Befehlszeilenschnittstelle ausführen:

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

3. Stellen Sie Ihre Anwendung bereit.

Festlegen der Profiler-Senke mit dem Azure-Ressourcen-Explorer

Da es im Azure-Portal keine Möglichkeit gibt, die Senke „Application Insights Profiler für .NET“ festzulegen, können Sie den Azure-Ressourcen-Explorer verwenden, um die Senke festzulegen.

1. Überprüfen Sie, ob die Erweiterung „Microsoft Azure-Diagnose“ installiert ist, indem Sie die für die VM installierten Erweiterungen anzeigen.

   

2. Suchen Sie die Erweiterung „VM-Diagnose“ für Ihre VM:

   1. Wechseln Sie zum Azure-Ressourcen-Explorer.

   2. Klappen Sie Abonnements auf und wechseln Sie zum Abonnement, das die Ressourcengruppe mit Ihrer VM enthält.

   3. Gehen Sie bis zu Ihren VM-Erweiterungen, indem Sie Ihre Ressourcengruppe auswählen. Wählen Sie dann Microsoft.Compute>virtualMachines>[Ihre VM]>Erweiterungen aus.

      

3. Fügen Sie die Senke „Application Insights Profiler für .NET“ zum Knoten SinksConfig unter WadCfg hinzu. Wenn der Abschnitt SinksConfig noch nicht vorhanden ist, müssen Sie ihn hinzufügen. So fügen Sie die Senke hinzu

   • Geben Sie in den Einstellungen den richtigen iKey für Application Insights an.

   • Schalten Sie rechts oben den Explorer-Modus in Lesen/Schreiben um.

   • Wählen Sie Bearbeiten aus.

     

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

4. Wenn Sie die Bearbeitung der Konfiguration abgeschlossen haben, wählen Sie PUT aus.

5. Wenn der Vorgang put erfolgreich war, erscheint ein grünes Häkchen in der Mitte des Bildschirms.