Profilerstellung für Live-Azure App Service-Apps mit Application InsightsProfile live Azure App Service apps with Application Insights

Sie können Profiler für ASP.NET- und ASP.NET Core-Apps verwenden, die unter Azure App Service mit dem Dienstebene „Basic“ oder höher ausgeführt werden.You can run Profiler on ASP.NET and ASP.NET Core apps that are running on Azure App Service using Basic service tier or higher. Profiler unter Linux lässt sich derzeit nur mit dieser Methode aktivieren.Enabling Profiler on Linux is currently only possible via this method.

Aktivieren von Profiler für Ihre AppEnable Profiler for your app

Befolgen Sie die unten angegebene Anleitung, um Profiler für eine App zu aktivieren.To enable Profiler for an app, follow the instructions below. Wenn Sie eine andere Art von Azure-Dienst ausführen, helfen Ihnen diese Anleitungen zum Aktivieren von Profiler auf anderen unterstützten Plattformen weiter:If you're running a different type of Azure service, here are instructions for enabling Profiler on other supported platforms:

Application Insights Profiler ist als Teil der App Services-Runtime bereits vorinstalliert.Application Insights Profiler is pre-installed as part of the App Services runtime. In den folgenden Schritten wird erläutert, wie Sie das Tool für Ihren App Service aktivieren.The steps below will show you how to enable it for your App Service. Führen Sie diese Schritte aus, auch wenn Sie das App Insights SDK zum Zeitpunkt der Erstellung in Ihrer Anwendung eingefügt haben.Follow these steps even if you've included the App Insights SDK in your application at build time.

  1. Navigieren Sie zur Azure-Systemsteuerung für Ihre App Service-Instanz.Navigate to the Azure control panel for your App Service.

  2. Aktivieren Sie die Einstellung „Always On“ für Ihren App Service.Enable "Always On" setting for your app service. Sie finden diese Einstellung unter Einstellungen, Seite Konfiguration (siehe Screenshot im nächsten Schritt). Klicken Sie dann auf die Registerkarte Allgemeine Einstellungen.You can find this setting under Settings, Configuration page (see screenshot in the next step), and click the General settings tab.

  3. Navigieren Sie zur Seite Einstellungen > Application Insights.Navigate to Settings > Application Insights page.

    Aktivieren von App Insights im App Services-Portal

  4. Befolgen Sie die Anweisungen im Bereich zum Erstellen einer neuen Ressource, oder wählen Sie eine vorhandene App Insights-Ressource aus, um Ihre App zu überwachen.Either follow the instructions on the pane to create a new resource or select an existing App Insights resource to monitor your app. Vergewissern Sie sich außerdem, dass der Profiler auf Ein festgelegt ist.Also make sure the Profiler is On. Wenn sich Ihre Application Insights-Ressource in einem anderen Abonnement als Ihr App Service befindet, können Sie Application Insights auf dieser Seite nicht konfigurieren.If your Application Insights resource is in a different subscription from your App Service, you can't use this page to configure Application Insights. Sie können die Konfiguration jedoch manuell vornehmen, indem Sie die gewünschten App-Einstellungen manuell erstellen.You can still do it manually though by creating the necessary app settings manually. Der nächste Abschnitt enthält Anweisungen zum manuellen Aktivieren von Profiler.The next section contains instructions for manually enabling Profiler.

    Hinzufügen der App Insights-Websiteerweiterung

  5. Der Profiler wurde mithilfe einer App Services-App-Einstellung aktiviert.Profiler is now enabled using an App Services App Setting.

    App-Einstellung für Profiler

Manuelles Aktivieren von Profiler oder Aktivieren über Azure Resource ManagerEnable Profiler manually or with Azure Resource Manager

Application Insights Profiler kann aktiviert werden, indem Sie App-Einstellungen für Ihren Azure App Service erstellen.Application Insights Profiler can be enabled by creating app settings for your Azure App Service. Auf der oben abgebildeten Seite mit den Optionen werden diese App-Einstellungen automatisch erstellt.The page with the options shown above creates these app settings for you. Sie können die Erstellung dieser Einstellungen jedoch auch mithilfe einer Vorlage oder auf andere Weise automatisieren.But you can automate the creation of these settings using a template or other means. Diese Einstellungen funktionieren auch dann, wenn sich die Application Insights-Ressource in einem anderen Abonnement als Ihre Azure App Service-Instanz befindet.These settings will also work if your Application Insights resource is in a different subscription from your Azure App Service. Im Folgenden finden Sie die Einstellungen, die zum Aktivieren von Profiler erforderlich sind:Here are the settings needed to enable the profiler:

App-EinstellungApp Setting WertValue
APPINSIGHTS_INSTRUMENTATIONKEYAPPINSIGHTS_INSTRUMENTATIONKEY iKey für Ihre Application Insights-RessourceiKey for your Application Insights resource
APPINSIGHTS_PROFILERFEATURE_VERSIONAPPINSIGHTS_PROFILERFEATURE_VERSION 1.0.01.0.0
DiagnosticServices_EXTENSION_VERSIONDiagnosticServices_EXTENSION_VERSION ~3~3

Sie können diese Werte mithilfe von Azure Resource Manager-Vorlagen, Azure PowerShell oder der Azure-Befehlszeilenschnittstelle festlegen.You can set these values using Azure Resource Manager Templates, Azure PowerShell, Azure CLI.

Manuelles Aktivieren von Profiler für andere CloudsEnabling Profiler for other clouds manually

Wenn Sie Profiler für andere Clouds aktivieren möchten, können Sie die folgenden App-Einstellungen verwenden.If you want to enable the profiler for other clouds, you can use the below app settings.

App-EinstellungApp Setting US Government-WerteUS Government Values China-CloudChina Cloud
ApplicationInsightsProfilerEndpointApplicationInsightsProfilerEndpoint https://agent.serviceprofiler.azure.us https://profiler.applicationinsights.azure.cn
ApplicationInsightsProfilerEndpointApplicationInsightsEndpoint https://dc.applicationinsights.us https://dc.applicationinsights.azure.cn

Deaktivieren von ProfilerDisable Profiler

Wenn Sie Profiler für die Instanz einer einzelnen App beenden oder neu starten möchten, können Sie unter WebJobs den Webauftrag mit dem Namen „ApplicationInsightsProfiler3“ beenden.To stop or restart Profiler for an individual app's instance, under WebJobs and stop the webjob named ApplicationInsightsProfiler3. Auch wenn der Profiler wie oben beschrieben mithilfe des Schalters auf der Application Insights-Seite deaktiviert wurde, wird der Profilerprozess weiterhin ausgeführt.Even if the profiler is disabled using the switch on the Application Insights page as described above, the profiler process will still run. Der Profiler prüft, ob er aktiviert ist.The profiler will check to see if it's enabled. Wenn er deaktiviert ist, wechselt er für einen Zeitraum in den Ruhemodus, bevor er erneut geprüft wird.If it's disabled, it will go to sleep for a period of time before checking again. Bei Deaktivierung führt er keinerlei Profilerstellung aus.It doesn't do any profiling if it's disabled. Wenn Sie diesen Webauftrag deaktivieren, wird der Profilerprozess gar nicht ausgeführt, auch nicht um zu überprüfen, ob er aktiviert ist.If you disable this webjob, the profiler process won't run at all, even to check to see if it's enabled.

Deaktivieren von Profiler für einen Webauftrag

Es wird empfohlen, Profiler für alle Apps zu aktivieren, um Leistungsprobleme möglichst schnell zu ermitteln.We recommend that you have Profiler enabled on all your apps to discover any performance issues as early as possible.

Profiler-Dateien können gelöscht werden, wenn Änderungen mithilfe von WebDeploy in der Webanwendung bereitgestellt werden.Profiler's files can be deleted when using WebDeploy to deploy changes to your web application. Sie können die Löschung verhindern, indem Sie festlegen, dass der Ordner „App_Data“ vom Löschen bei der Bereitstellung ausgeschlossen wird.You can prevent the deletion by excluding the App_Data folder from being deleted during deployment.

Nächste SchritteNext steps