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

Artikel
10/28/2024

Hinweis

Es wird empfohlen, das Azure Az PowerShell-Modul für die Interaktion mit Azure zu verwenden. Informationen zu den ersten Schritten finden Sie unter Installieren von Azure PowerShell. Informationen zum Migrieren zum Az PowerShell-Modul finden Sie unter Migrieren von Azure PowerShell von AzureRM zum Az-Modul.

In diesem Artikel erfahren Sie, wie Sie Application Insights Profiler für .NET auf Ihrer Azure-VM oder in Ihrer VM-Skalierungsgruppe in Azure mithilfe dreier verschiedener Methoden ausführen können:

Visual Studio und Azure Resource Manager
PowerShell
Azure-Ressourcen-Explorer

Wählen Sie Ihre bevorzugte Methoden-Registerkarte für folgende Zwecke aus:

In diesem Artikel lernen Sie Folgendes:

Konfigurieren Sie die Erweiterung „Azure-Diagnose“, um den .NET-Profiler ausführen zu können.
Installieren des Application Insights SDK auf einer VM.
Stellen Sie Ihre Anwendung bereit.
Anzeigen von Profiler-Ablaufverfolgungen in der Application Insights-Instanz im Azure-Portal.

Voraussetzungen

Eine funktionierende ASP.NET Core-Anwendung.
Eine Application Insights-Ressource
So überprüfen Sie die Azure Resource Manager-Vorlagen (ARM-Vorlagen) für die Erweiterung Azure-Diagnose:
- VM
- VM-Skalierungsgruppe

Fügen Sie das Application Insights SDK zu Ihrer Anwendung hinzu

Öffnen Sie Ihr ASP.NET Core-Projekt in Visual Studio.
Wählen Sie Projekt>Application Insights-Telemetrie hinzufügen aus.
Wählen Sie Azure Application Insights>Weiter aus.
Wählen Sie das Abonnement, in dem sich Ihre Application Insights-Ressource befindet, und wählen Sie dann Weiter.
Wählen Sie aus, wo die Verbindungszeichenfolge gespeichert werden soll, und wählen Sie dann Weiter.
Wählen Sie Fertig stellen aus.

Hinweis

Vollständige Anweisungen, einschließlich der Aktivierung von Application Insights für Ihre ASP.NET Core-Anwendung ohne Visual Studio, finden Sie unter Application Insights für ASP.NET Core-Anwendungen.

Durchführen eines Upgrades auf die neueste Version des Application Insights SDK

Wechseln Sie zu Projekt> NuGet-Pakete verwalten.
Wählen Sie Microsoft.ApplicationInsights.AspNetCore aus.
Wählen Sie im Seitenbereich die neueste Version des SDK aus der Dropdown-Liste.
Wählen Sie Aktualisieren aus.

Aktivieren des .NET Profilers

Sie können Profiler auf eine der drei folgenden Arten aktivieren:

Innerhalb Ihrer ASP.NET Core-Anwendung unter Verwendung einer Azure Resource Manager-Vorlage und Visual Studio. Empfohlen.
Mit einem PowerShell-Befehl über die Azure CLI.
Mit Azure-Ressourcen-Explorer.

Installieren der Azure-Diagnoseerweiterung

Wählen Sie die zu verwendende ARM-Vorlage:
- VM
- VM-Skalierungsgruppe
Suchen Sie in der Vorlage die Ressource mit dem Typ extension.
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.
Fügen Sie den Ressourcentyp extension aus der Vorlage zur Datei arm.json hinzu, um eine VM oder VM-Skalierungsgruppe mit Azure-Diagnose einzurichten.

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"
      }
    ]
  }
}

Stellen Sie Ihre Anwendung bereit.

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

Hinweis

Wenn Sie die VM erneut bereitstellen, geht die Senke verloren. Sie müssen die Konfiguration aktualisieren, die Sie bei der Bereitstellung der VM verwenden, um diese Einstellung beizubehalten.

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

Exportieren Sie die aktuell bereitgestellte Konfiguration der Azure-Diagnose in eine Datei:
```
$ConfigFilePath = [IO.Path]::GetTempFileName()
```

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"
      }
    ]
  }
}

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:

Richten Sie einen Remotezugriff auf die Umgebung ein.
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"
```
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.

Hinweis

Wenn Sie die VM erneut bereitstellen, geht die Senke verloren. Sie müssen die Konfiguration aktualisieren, die Sie bei der Bereitstellung der VM verwenden, um diese Einstellung beizubehalten.

Überprüfen Sie, ob die Erweiterung „Microsoft Azure-Diagnose“ installiert ist, indem Sie die für die VM installierten Erweiterungen anzeigen.
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.
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"
      }
    ]
  }
}        
```
Wenn Sie die Bearbeitung der Konfiguration abgeschlossen haben, wählen Sie PUT aus.
Wenn der Vorgang put erfolgreich war, erscheint ein grünes Häkchen in der Mitte des Bildschirms.