Aktivieren des Momentaufnahmedebuggers für .NET-Apps in Azure App Service

Der Momentaufnahmedebugger unterstützt derzeit ASP.NET- und ASP.NET Core-Apps, die unter Azure App Service in Windows-Dienstplänen ausgeführt werden.

Hinweis

Wenn Sie eine Vorschauversion von .NET Core verwenden oder Ihre Anwendung direkt oder indirekt über eine abhängige Assembly auf Application Insights SDK verweist, befolgen Sie die Anweisungen zum Aktivieren des Snapshotdebuggers für andere Umgebungen , um das Microsoft.ApplicationInsights.SnapshotCollector NuGet-Paket in die Anwendung aufzunehmen.

Wenn Sie den Momentaufnahmedebugger verwenden, wird empfohlen, Ihre Anwendung auf der Dienstebene „Basic“ oder einer höheren auszuführen. Für die meisten Anwendungen gilt:

• Die Dienstebenen „Free“ und „Shared“ haben nicht genügend Arbeits- oder Festplattenspeicher zum Speichern von Momentaufnahmen.
• Die Verbrauchsstufe ist momentan für den Snapshot-Debugger nicht verfügbar.

Der Momentaufnahmedebugger ist als Teil der App Services-Runtime zwar bereits vorinstalliert, muss aber noch aktiviert werden, um Momentaufnahmen für Ihre App Service-App zu erhalten. Die codefreie Installation des Momentaufnahmedebuggers folgt der .NET Core-Supportrichtlinie.

Azure-Portal

Sie können den Momentaufnahmedebugger im Azure-Portal aktivieren, nachdem Sie Ihre .NET App Services-Web-App bereitgestellt haben.

1. Navigieren Sie im Azure-Portal zu Ihrer App Services-Web-App.

2. Wählen Sie im linken Menü "Monitoring>Application Insights" aus.

   

3. Wählen Sie "Application Insights aktivieren" aus.

   Wenn Sie lieber eine vorhandene Application Insights-Ressource verwenden möchten, wählen Sie diese Option unter Ressource ändern aus.

4. Wählen Sie unter Instrumentieren Sie Ihre Anwendung, .NET aus.

5. Schalten Sie beide Umschalter für den Momentaufnahmedebugger auf Ein um.

   

6. Der Momentaufnahmedebugger ist jetzt aktiviert.

Deaktivieren des Momentaufnahmedebuggers

So deaktivieren Sie den Momentaufnahmedebugger für Ihre App Services-Ressource

1. Navigieren Sie im Azure-Portal zu Ihrer App Service-Instanz.

2. Wählen Sie im linken Menü "Monitoring>Application Insights" aus.

3. Schalten Sie die Umschalter für den Momentaufnahmedebugger auf Aus um.

Azure Resource Manager

Sie können auch Snapshot Debugger und .NET Profiler mithilfe von App-Einstellungen in der Azure Resource Manager-Vorlage aktivieren. Zum Beispiel:

{
  "apiVersion": "2023-12-01",
  "name": "[parameters('webSiteName')]",
  "type": "Microsoft.Web/sites",
  "location": "[resourceGroup().location]",
  "dependsOn": [
    "[variables('hostingPlanName')]"
  ],
  "tags": { 
    "[concat('hidden-related:', resourceId('Microsoft.Web/serverfarms', variables('hostingPlanName')))]": "empty",
    "displayName": "Website"
  },
  "properties": {
    "name": "[parameters('webSiteName')]",
    "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', variables('hostingPlanName'))]"
  },
  "resources": [
    {
      "apiVersion": "2015-08-01",
      "name": "appsettings",
      "type": "config",
      "dependsOn": [
        "[parameters('webSiteName')]",
        "[concat('AppInsights', parameters('webSiteName'))]"
      ],
      "properties": {
        "APPINSIGHTS_INSTRUMENTATIONKEY": "[reference(resourceId('Microsoft.Insights/components', concat('AppInsights', parameters('webSiteName'))), '2014-04-01').InstrumentationKey]",
        // "Turn on" a Snapshot Debugger version
        "APPINSIGHTS_SNAPSHOTFEATURE_VERSION": "1.0.0",
        "DiagnosticServices_EXTENSION_VERSION": "~3",
        "ApplicationInsightsAgent_EXTENSION_VERSION": "~2"
      }
    }
  ]
},

Generieren Sie Datenverkehr für Ihre Anwendung, der eine Ausnahme auslösen kann. Warten Sie dann 10 bis 15 Minuten, bis die Momentaufnahmen an die Application Insights-Instanz gesendet werden.

Aktivieren des Momentaufnahmedebuggers für andere Cloudregionen

Derzeit sind die einzigen Regionen, die Endpunktänderungen erfordern, Azure Government und Microsoft Azure, betrieben von 21Vianet über die Application Insights Connection String.

Eigenschaft mit der Verbindungszeichenfolge	US Government-Cloud	China-Cloud
SnapshotEndpoint	https://snapshot.monitor.azure.us	https://snapshot.monitor.azure.cn

Weitere Informationen zu anderen Verbindungsüberschreibungen finden Sie in der Application Insights-Dokumentation.

Konfigurieren des Momentaufnahmedebuggers

Aktivieren Sie die Microsoft Entra-Authentifizierung für die Erfassung von Momentaufnahmen

Der Momentaufnahmedebugger unterstützt die Microsoft Entra-Authentifizierung für die Momentaufnahmenerfassung. Ihre Anwendung muss authentifiziert werden und die erforderlichen Anwendungseinstellungen für den Momentaufnahmedebugger-Agent bereitstellen, damit alle Momentaufnahmen Ihrer Anwendung erfasst werden können.

Hinweis

Derzeit unterstützt der Momentaufnahmedebugger die Microsoft Entra-Authentifizierung nur, wenn Sie mit dem Application Insights SDK in Ihrer Anwendung auf Microsoft Entra ID verweisen und diese konfigurieren.

1. Fügen Sie die verwaltete Identität für die Authentifizierung bei Ihrer Application Insights-Ressource Ihrem App Service hinzu. Sie haben zwei Möglichkeiten:

   • Eine systemseitig zugewiesene verwaltete Identität
   • Eine benutzerseitig zugewiesene verwaltete Identität

2. Konfigurieren und aktivieren Sie im Azure-Portal die Microsoft Entra-ID in Ihrer Application Insights-Ressource.

3. Fügen Sie die folgende Anwendungseinstellung hinzu. Diese Einstellung teilt dem Momentaufnahmedebugger-Agent mit, welche verwaltete Identität verwendet werden soll:

   Für systemseitig zugewiesene Identität:

   App-Einstellung	Wert
   APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Authorization=AD

   Für benutzerseitig zugewiesene Identität:

   App-Einstellung	Wert
   APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Authorization=AD;ClientId={Client-ID der benutzerseitig zugewiesenen Identität}

Nicht unterstützte Szenarien

Das folgende Szenario zeigt, wo Snapshot Collector nicht unterstützt wird.

Szenario	Nebeneffekte	Empfehlung
Sie verwenden das Snapshot Collector-SDK direkt in Ihrer Anwendung (CSPROJ) und haben die erweiterte Option Interop aktiviert.	Das lokale Application Insights SDK, einschließlich Snapshot Collector-Telemetrie, geht verloren, und es sind keine Momentaufnahmen verfügbar. Ihre Anwendung kann beim Start mit System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor. abstürzen. Weitere Informationen zum Feature "Interoperabilität von Application Insights" finden Sie unter "Problembehandlung bei der Integration von Application Insights".	Wenn Sie die erweiterte Option Interop verwenden, verwenden Sie die codelose Snapshot Collector-Einfügung, die über das Azure-Portal aktiviert ist.

Verwandte Inhalte

• Zeigen Sie Momentaufnahmen im Azure-Portal an.
• Probleme mit dem Momentaufnahmedebugger beheben.