Upgraden des Momentaufnahmedebuggers

Wichtig

Microsoft rückt aufgrund von Sicherheitsrisiken von TLS 1.0 und TLS 1.1 ab. Wenn Sie eine ältere Version der Websiteerweiterung verwenden, müssen Sie Ihre Instanzen des Momentaufnahmedebuggers auf die neueste Version aktualisieren.

Je nachdem, wie Sie den Momentaufnahmedebugger aktiviert haben, können Sie zwei primäre Upgradepfade verfolgen:

  • Über die Websiteerweiterung
  • Über ein SDK/NuGet, das zu Ihrer Anwendung hinzugefügt wird

Wichtig

Bei älteren Versionen von Application Insights wurde eine private Websiteerweiterung mit dem Namen Application Insights-Erweiterung für Azure App Service verwendet. Die aktuelle Application Insights-Oberfläche wird aktiviert, indem die App-Einstellungen auf das Anzeigen einer vorinstallierten Websiteerweiterung festgelegt werden. Um Konflikte zu vermeiden, durch die Ihre Website möglicherweise nicht mehr funktioniert, muss zuerst die private Websiteerweiterung gelöscht werden. Weitere Informationen finden Sie in Schritt 4 im folgenden Verfahren.

Wenn Sie den Momentaufnahmedebugger mithilfe der Websiteerweiterung aktiviert haben, können Sie das Upgrade wie folgt durchführen:

  1. Melden Sie sich beim Azure-Portal an.

  2. Wechseln Sie zu Ihrer Ressource, für die Application Insights und der Momentaufnahmedebugger aktiviert sind. Wechseln Sie also beispielsweise bei einer Web-App zur Azure App Service-Ressource.

    Screenshot: App Service-Ressource namens „DiagService01“

  3. Wählen Sie den Bereich Erweiterungen aus. Warten Sie, bis die Liste mit den Erweiterungen angezeigt wird.

    Screenshot: App Service-Erweiterungen mit installierter Application Insights-Erweiterung für Azure App Service

  4. Wenn eine Version von Application Insights-Erweiterung für Azure App Service installiert ist, wählen Sie diese aus, und klicken Sie auf Löschen. Bestätigen Sie mit Ja, um die Erweiterung zu löschen. Warten Sie, bis der Löschvorgang abgeschlossen ist, bevor Sie mit dem nächsten Schritt fortfahren.

    Screenshot: App Service-Erweiterungen mit der Schaltfläche „Löschen“ für Application Insights-Erweiterung für Azure App Service

  5. Wechseln Sie zum Bereich Übersicht Ihrer Ressource, und klicken Sie auf Application Insights.

    Screenshot: Auswählen der Schaltfläche „Application Insights”

  6. Wenn Sie den Bereich Application Insights zum ersten Mal für diese App Service-Instanz anzeigen, werden Sie aufgefordert, Application Insights zu aktivieren. Wählen Sie Application Insights aktivieren aus.

    Screenshot: Schaltfläche „Application Insights aktivieren“

  7. Schalten Sie im Bereich mit den Application Insights-Einstellungen die Momentaufnahmedebugger-Einstellung auf Ein um, und wählen Sie Übernehmen aus.

    Wenn Sie sich entscheiden, beliebige Application Insights-Einstellungen zu ändern, wird die Schaltfläche Übernehmen aktiviert.

    Screenshot: App Service-Konfigurationsseite von Application Insights mit hervorgehobener Schaltfläche „Übernehmen“

  8. Nach dem Klicken auf Übernehmen werden Sie aufgefordert, die Änderungen zu bestätigen.

    Hinweis

    Die Website wird im Rahmen des Upgradeprozesses neu gestartet.

    Screenshot: Aufforderung zur Bestätigung der Änderungen an den App Service-Einstellungen

  9. Klicken Sie auf Ja, um die Änderungen zu übernehmen, und warten Sie, bis der Vorgang abgeschlossen ist.

Die Website ist nun aktualisiert und verwendungsbereit.

Nächste Schritte