Activer Profiler pour les applications Azure App Service

  • Article

Application Insights Profiler est préinstallé dans le cadre du runtime d’Azure App Service. Vous pouvez exécuter Profiler sur des applications ASP.NET et ASP.NET Core qui s’exécutent sur App Service avec le niveau de service de base ou supérieur. Suivez ces étapes, même si vous avez inclus le kit de développement logiciel (SDK) Application Insights dans votre application au moment de la génération.

Pour activer Profiler sur Linux, parcourez les instructions relatives aux applications web Linux Azure ASP.NET Core.

Notes

L’installation sans code d’Application Insights Profiler suit la politique de support .NET Core. Pour plus d’informations sur les runtimes pris en charge, consultez Politique de support .NET Core.

Prérequis

Vérifiez l’activation du paramètre « Always on »

  1. Dans le portail Azure, accédez à votre application App Service.

  2. Sous Paramètres dans le volet gauche, sélectionnez Configuration.

    Screenshot that shows selecting Configuration on the left pane.

  3. Sélectionnez l’onglet Paramètres généraux.

  4. Vérifiez que Always On>On est sélectionné.

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

  5. Le cas échéant, sélectionnez Enregistrer.

Activer Application Insights et Profiler

Les sections suivantes vous montrent comment activer Application Insights pour le même abonnement ou pour différents abonnements.

Pour Application Insights et App Service dans le même abonnement

Si votre ressource Application Insights est dans le même abonnement que votre instance App Service :

  1. Sous Paramètres dans le volet gauche, sélectionnez Application Insights.

    Screenshot that shows selecting Application Insights on the left pane.

  2. Sous Application Insights, sélectionnez Activer.

  3. Vérifiez que vous avez connecté une ressource Application Insights à votre application.

    Screenshot that shows enabling Application Insights on your app.

  4. Faites défiler vers le bas et sélectionnez l’onglet .NET ou .NET Core, selon votre application.

  5. Vérifiez que Niveau de la collection>Recommandé est sélectionné.

  6. Sous Profiler, sélectionnez On.

    Si vous avez choisi le niveau de collection Basic précédemment, le paramètre Profiler est désactivé.

  7. Sélectionnez Appliquer>Oui pour confirmer.

    Screenshot that shows enabling Profiler on your app.

Pour Application Insights et App Service dans différents abonnements

Si votre ressource Application Insights se trouve dans un abonnement différent de votre instance App Service, vous devez manuellement activer Profiler en créant des paramètres d’application pour votre instance App Service. Vous pouvez automatiser la création de ces paramètres avec un modèle ou par d’autres moyens. Voici les paramètres dont vous avez besoin pour activer Profiler.

Paramètre d’application Valeur
APPINSIGHTS_INSTRUMENTATIONKEY iKey pour votre ressource Application Insights
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
DiagnosticServices_EXTENSION_VERSION ~3

Configurez ces valeurs en utilisant :

Activer Profiler pour des clouds régionaux

Seules les régions Azure Government et Microsoft Azure géré par 21Vianet nécessitent actuellement des modifications de leurs points de terminaison.

Paramètre d’application Cloud US Government China Cloud
ApplicationInsightsProfilerEndpoint https://profiler.monitor.azure.us https://profiler.monitor.azure.cn
ApplicationInsightsEndpoint https://dc.applicationinsights.us https://dc.applicationinsights.azure.cn

Activer l’authentification Microsoft Entra pour l’ingestion des profils

Application Insights Profiler prend en charge l’authentification Microsoft Entra pour l’ingestion des profils. Pour que tous les profils de votre application soient ingérés, votre application doit être authentifiée et fournir les paramètres d’application requis à l’agent Profiler.

Profiler ne prend en charge l’authentification Microsoft Entra ID que lorsque vous référencez et configurez Microsoft Entra à l’aide du Kit de développement logiciel (SDK) Application Insights dans votre application.

Pour activer Microsoft Entra ID pour l’ingestion des profils :

  1. Créez et ajoutez l’identité managée pour vous authentifier auprès de votre ressource Application Insights sur votre instance App Service :

    1. Documentation relative à l’identité managée affectée par le système

    2. Documentation relative à l’identité managée affectée par l’utilisateur

  2. Configurez et activez Microsoft Entra ID dans votre ressource Application Insights.

  3. Ajoutez le paramètre d’application suivant pour que l’agent Profiler sache quelle identité managée utiliser.

    • Pour l'identité affectée par le système :

      Paramètre d’application Valeur
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD

    • Pour l’identité affectée par l’utilisateur :

      Paramètre d’application Valeur
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD;ClientId={Client id of the User-Assigned Identity}

Désactiver Profiler

Pour arrêter ou redémarrer Profiler pour une instance d’application individuelle :

  1. Sous Paramètres dans le volet gauche, sélectionnez WebJobs (tâches web).

    Screenshot that shows selecting web jobs on the left pane.

  2. Sélectionnez la tâche web nommée ApplicationInsightsProfiler3.

  3. Sélectionnez Arrêter.

    Screenshot that shows selecting stop for stopping the webjob.

  4. Sélectionnez Oui pour confirmer.

Nous vous recommandons d’activer dès que possible Profiler sur toutes vos applications afin de découvrir d’éventuels problèmes de performance.

Vous pouvez supprimer les fichiers de Profiler lorsque vous utilisez WebDeploy pour déployer les modifications apportées à votre application web. Vous pouvez empêcher la suppression en excluant le dossier App_Data des éléments supprimés au cours du déploiement.

Étapes suivantes