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

Hinweis

Wenn Sie eine Vorschauversion von .NET Core verwenden oder Ihre Anwendung (direkt oder indirekt über eine abhängige Assembly) auf das Application Insights SDK verweist, führen Sie die Anweisungen unter Aktivieren des Momentaufnahmedebuggers für andere Umgebungen aus, um das NuGet-Paket Microsoft.ApplicationInsights.SnapshotCollector in die Anwendung zu integrieren.

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

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 Verbrauchsebene ist derzeit für den Momentaufnahmedebugger 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-Apps zu erhalten. Die codefreie Installation des Application Insights-Momentaufnahmedebuggers folgt der .NET Core-Supportrichtlinie.

Azure portal

Nachdem Sie Ihre .NET-App Services-Web-App bereitgestellt haben:

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

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

   

3. Klicken Sie auf Application Insights einschalten.

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

4. Wählen Sie unter Anwendung instrumentieren die Registerkarte .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ü Einstellungen>Application Insights aus.
3. Schalten Sie die Umschalter für den Momentaufnahmedebugger auf Aus um.

Azure Resource Manager

Sie können auch App-Einstellungen innerhalb der Azure Resource Manager-Vorlage festlegen, um den Momentaufnahmedebugger und Profiler zu 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 Azure Government und Microsoft Azure betrieben von 21Vianet die einzigen Regionen, für die Endpunktänderungen über die Application Insights-Verbindungszeichenfolge erforderlich sind.

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 der Microsoft Entra-Authentifizierung für die Momentaufnahmenerfassung

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.

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

So aktivieren Sie Microsoft Entra ID für die Erfassung von Momentaufnahmen in Ihrer App Services-Ressource

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:

   • Hinzufügen einer systemseitig zugewiesenen verwalteten Identität
   • Hinzufügen einer benutzerseitig zugewiesenen verwalteten Identität

2. Konfigurieren und aktivieren Sie Microsoft Entra ID in Ihrer Application Insights-Ressource. Weitere Informationen finden Sie in der folgenden Dokumentation.

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

In den folgenden Szenarios wird Snapshot Collector nicht unterstützt:

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. Erfahren Sie mehr über das Application Insights-Feature „Interop“.	Wenn Sie die erweiterte Option „Interop“ verwenden, nutzen Sie die codelose Snapshot Collector-Einschleusung (aktiviert über das Azure-Portal).

Nächste Schritte

• Zeigen Sie Momentaufnahmen im Azure-Portal an.
• Behandeln von Problemen mit dem Momentaufnahmedebugger.