Profiler inschakelen voor Azure-app Service-apps

Application Insights Profiler is vooraf geïnstalleerd als onderdeel van de Azure-app Service-runtime. U kunt Profiler uitvoeren op ASP.NET en ASP.NET Core-apps die worden uitgevoerd in App Service met behulp van de Basic-servicelaag of hoger. Volg deze stappen, zelfs als u de Application Insights SDK tijdens de build in uw toepassing hebt opgenomen.

Als u Profiler in Linux wilt inschakelen, doorloopt u de instructies voor de ASP.NET Core Azure Linux-web-apps.

Notitie

Installatie zonder code van Application Insights Profiler volgt het .NET Core-ondersteuningsbeleid. Zie .NET Core-ondersteuningsbeleid voor meer informatie over ondersteunde runtime.

Vereisten

Controleer of de instelling Altijd ingeschakeld is

  1. Ga in Azure Portal naar uw App Service-exemplaar.

  2. Selecteer Configuratie onder Instellingen in het linkerdeelvenster.

    Screenshot that shows selecting Configuration on the left pane.

  3. Selecteer het tabblad Algemene instellingen.

  4. Controleer of AlwaysOn> is geselecteerd.

    Screenshot that shows the General tab on the Configuration pane showing that Always On is enabled.

  5. Selecteer Opslaan als u wijzigingen hebt aangebracht.

Application Insights en Profiler inschakelen

In de volgende secties ziet u hoe u Application Insights inschakelt voor hetzelfde abonnement of verschillende abonnementen.

Voor Application Insights en App Service in hetzelfde abonnement

Als uw Application Insights-resource zich in hetzelfde abonnement bevindt als uw exemplaar van App Service:

  1. Selecteer Application Insights onder Instellingen in het linkerdeelvenster.

    Screenshot that shows selecting Application Insights on the left pane.

  2. Selecteer Inschakelen onder Application Insights.

  3. Controleer of u een Application Insights-resource hebt verbonden met uw app.

    Screenshot that shows enabling Application Insights on your app.

  4. Schuif omlaag en selecteer het tabblad .NET of .NET Core , afhankelijk van uw app.

  5. Controleer of het aanbevolen verzamelingsniveau> is geselecteerd.

  6. Selecteer Onder Profiler de optie Aan.

    Als u eerder het niveau Basic-verzameling hebt gekozen, wordt de profiler-instelling uitgeschakeld.

  7. Selecteer Ja toepassen>om te bevestigen.

    Screenshot that shows enabling Profiler on your app.

Voor Application Insights en App Service in verschillende abonnementen

Als uw Application Insights-resource zich in een ander abonnement bevindt dan uw exemplaar van App Service, moet u Profiler handmatig inschakelen door app-instellingen voor uw App Service-exemplaar te maken. U kunt het maken van deze instellingen automatiseren met behulp van een sjabloon of andere middelen. Dit zijn de instellingen die u nodig hebt om Profiler in te schakelen.

App-instelling Waarde
APPINSIGHTS_INSTRUMENTATIONKEY iKey voor uw Application Insights-resource
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
DiagnosticServices_EXTENSION_VERSION ~3

Stel deze waarden in met behulp van:

Profiler inschakelen voor regionale clouds

Momenteel zijn de enige regio's die eindpuntwijzigingen vereisen Azure Government en Microsoft Azure beheerd door 21Vianet.

App-instelling Cloud voor de Amerikaanse overheid China-cloud
ApplicationInsightsProfilerEndpoint https://profiler.monitor.azure.us https://profiler.monitor.azure.cn
ApplicationInsightsEndpoint https://dc.applicationinsights.us https://dc.applicationinsights.azure.cn

Microsoft Entra-verificatie inschakelen voor profielopname

Application Insights Profiler ondersteunt Microsoft Entra-verificatie voor profielopname. Voor alle profielen van uw toepassing die moeten worden opgenomen, moet uw toepassing worden geverifieerd en de vereiste toepassingsinstellingen opgeven voor de Profiler-agent.

Profiler biedt alleen ondersteuning voor Microsoft Entra-verificatie wanneer u naar Microsoft Entra-id verwijst en configureert met behulp van de Application Insights SDK in uw toepassing.

Microsoft Entra-id inschakelen voor profielopname:

  1. Maak en voeg de beheerde identiteit toe om te verifiëren bij uw Application Insights-resource aan uw App Service:

    1. Documentatie voor door het systeem toegewezen beheerde identiteit

    2. Documentatie voor door de gebruiker toegewezen beheerde identiteit

  2. Configureer en schakel Microsoft Entra-id in uw Application Insights-resource in.

  3. Voeg de volgende toepassingsinstelling toe om de Profiler-agent te laten weten welke beheerde identiteit moet worden gebruikt.

    • Voor door het systeem toegewezen identiteit:

      App-instelling Waarde
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD
    • Voor door de gebruiker toegewezen identiteit:

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

Profiler uitschakelen

Profiler stoppen of opnieuw starten voor het exemplaar van een afzonderlijke app:

  1. Selecteer webtaken onder Instellingen in het linkerdeelvenster.

    Screenshot that shows selecting web jobs on the left pane.

  2. Selecteer de webtaak met de naam ApplicationInsightsProfiler3.

  3. Selecteer Stoppen.

    Screenshot that shows selecting stop for stopping the webjob.

  4. Selecteer Ja om te bevestigen.

U wordt aangeraden Profiler in al uw apps in te schakelen om prestatieproblemen zo vroeg mogelijk te detecteren.

U kunt de bestanden van Profiler verwijderen wanneer u WebDeploy gebruikt om wijzigingen in uw webtoepassing te implementeren. U kunt voorkomen dat de map App_Data wordt verwijderd tijdens de implementatie.

Volgende stappen