Freigeben über

Aktivieren von .NET Profiler für Azure Cloud Service-Apps

  • Artikel

Application Insights Profiler for .NET ist als Teil der Azure App Service-Runtime vorinstalliert. Sie können Profiler für ASP.NET- und ASP.NET Core-Apps verwenden, die unter App Service mit der Dienstebene „Basic“ oder höher ausgeführt werden.

Die codefreie Installation von Application Insights Profiler for .NET weist folgende Merkmale auf:

Um .NET Profiler unter Linux zu aktivieren, führen Sie die Anweisungen für ASP.NET Core-Azure Linux-Web-Apps aus.

Voraussetzungen

Überprüfen, ob die Einstellung „Always On“ aktiviert ist

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

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

    Der Screenshot zeigt das Auswählen von „Konfiguration“ im linken Bereich.

  3. Wählen Sie die Registerkarte Allgemeine Einstellungen aus.

  4. Überprüfen Sie, ob Always On>Ein ausgewählt ist.

    Hinweis

    Wenn die Umschaltfläche Always On deaktiviert ist, aktualisieren Sie die App-Web-App auf die Basic-Ebene oder höher.

    Der Screenshot zeigt die Registerkarte „Allgemein“ im Bereich „Konfiguration“, auf der die Option „Always On“ aktiviert ist.

  5. Wählen Sie Speichern aus, wenn Sie Änderungen vorgenommen haben.

Aktivieren von Application Insights und des .NET Profiler

Sie können den Profiler in einem der folgenden Fälle aktivieren:

Für Application Insights und App Service im selben Abonnement

Wenn sich Ihre Application Insights-Ressource in demselben Abonnement wie Ihre Instanz von App Service befindet:

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

  2. Wählen Sie unter Application Insights die Option Aktivieren aus.

  3. Vergewissern Sie sich, dass Sie eine Application Insights-Ressource mit Ihrer App verbunden haben.

    Der Screenshot zeigt das Aktivieren von Application Insights in Ihrer App.

  4. Scrollen Sie nach unten, und wählen Sie je nach App die Registerkarte .NET oder .NET Core aus.

  5. Vergewissern Sie sich, dass Sammlungsebene>Empfohlen ausgewählt ist.

  6. Wählen Sie unter Profiler die Option Ein aus.

    Wenn Sie zuvor die Sammlungsebene Basic ausgewählt haben, ist die Profiler-Einstellung deaktiviert.

  7. Wählen Sie Anwenden>Ja aus, um dies zu bestätigen.

    Der Screenshot zeigt das Aktivieren von Profiler in Ihrer App.

Für Application Insights und App Service in verschiedenen Abonnements

Wenn sich Ihre Application Insights-Ressource in einem anderen Abonnement als Ihre Instanz von App Service befindet, müssen Sie Profiler for .NET manuell aktivieren, indem Sie App-Einstellungen für diese Instanz erstellen. Sie können die Erstellung dieser Einstellungen mithilfe einer Vorlage oder auf andere Weise automatisieren. Hier sind die Einstellungen, die Sie zum Aktivieren von Profiler benötigen.

App-Einstellung Wert
APPINSIGHTS_INSTRUMENTATIONKEY iKey für Ihre Application Insights-Ressource
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
DiagnosticServices_EXTENSION_VERSION ~3

Legen Sie diese Werte mithilfe von Folgendem fest:

Aktivieren des .NET Profiler für Cloudbereiche

Derzeit sind Azure Government und Microsoft Azure operated by 21Vianet die einzigen Regionen, für die Endpunktänderungen erforderlich sind.

App-Einstellung US Government-Cloud China-Cloud
ApplicationInsightsProfilerEndpoint https://profiler.monitor.azure.us https://profiler.monitor.azure.cn
ApplicationInsightsProfilerEndpoint https://dc.applicationinsights.us https://dc.applicationinsights.azure.cn

Aktivieren der Microsoft Entra-Authentifizierung für die Profilerfassung

Application Insights Profiler for .NET unterstützt Microsoft Entra-Authentifizierung für die Profilerfassung. Ihre Anwendung muss authentifiziert werden und die erforderlichen Anwendungseinstellungen für den Profiler-Agent bereitstellen, damit alle Profile Ihrer Anwendung erfasst werden können.

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

Aktivieren der Microsoft Entra ID für die Profilerfassung:

  1. Erstellen Sie die verwaltete Identität für die Authentifizierung bei Ihrer Application Insights-Ressource, und fügen Sie sie Ihrem App Service hinzu:

    1. Dokumentation zur systemseitig zugewiesenen verwalteten Identität

    2. Dokumentation zur benutzerseitig zugewiesenen verwalteten Identität

  2. Konfigurieren und aktivieren Sie Microsoft Entra ID in Ihrer Application Insights-Ressource.

  3. Fügen Sie die folgende Anwendungseinstellung hinzu, um den Profiler-Agent zu informieren, welche verwaltete Identität verwendet werden soll.

    • Für systemseitig zugewiesene Identität:

      App-Einstellung Wert
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD

    • Für benutzerseitig zugewiesene Identität:

      App-Einstellung Wert
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD;ClientId={Client id of the User-Assigned Identity}

Deaktivieren des .NET Profiler

Wenn Sie Profiler für eine einzelne Instanz einer App beenden oder neu starten möchten:

  1. Wählen Sie im linken Bereich unter Einstellungen die Option WebJobs (Webaufträge) aus.

    Der Screenshot zeigt das Auswählen von Webaufträgen im linken Bereich.

  2. Wählen Sie den WebJob namens ApplicationInsightsProfiler3 aus.

  3. Wählen Sie Stop (Beenden) aus.

    Der Screenshot zeigt das Auswählen von „Stopp“, um den Webauftrag anzuhalten.

  4. Klicken Sie auf Ja, um zu bestätigen.

Es wird empfohlen, Profiler für alle Apps zu aktivieren, um Leistungsprobleme möglichst schnell zu ermitteln.

Sie können die Profiler-Dateien löschen, wenn Sie Änderungen an Ihrer Webanwendung mithilfe von WebDeploy bereitstellen. Sie können die Löschung verhindern, indem Sie festlegen, dass der Ordner App_Data während der Bereitstellung nicht gelöscht werden soll.

Nächste Schritte