Activer le Profiler .NET pour les applications Azure App Service

  • Article

Application Insights Profiler pour .NET 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.

L’installation sans code d’Application Insights Profiler pour .NET :

Pour activer Profiler .NET sur Linux, parcourez les instructions relatives aux applications web Linux Azure ASP.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. Dans le menu de gauche, sélectionnez Paramètres>Configuration.

    Capture d’écran montrant la sélection de Configuration dans le volet gauche.

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

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

    Remarque

    Si le bouton bascule Always On est désactivé, mettez à niveau votre application web App Service pour qu’elle s’exécute au niveau De base ou supérieur.

    Capture d’écran de l’onglet Général du volet Configuration, montrant que l’option Always On est activée.

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

Activez Application Insights et le Profiler .NET

Vous pouvez activer Profiler quand :

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. Dans le menu de gauche, sélectionnez Surveillance>Application Insights.

  2. Sous Application Insights, sélectionnez Activer.

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

    Capture d’écran montrant l’activation d’Application Insights dans votre application.

  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.

    Capture d’écran montrant l’activation de Profiler dans votre application.

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 le Profiler pour .NET 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 .NET 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 pour .NET 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 le Profiler .NET

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).

    Capture d’écran montrant la sélection des tâches web dans le volet gauche.

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

  3. Sélectionnez Arrêter.

    Capture d’écran montrant la sélection de l’arrêt pour arrêter la tâche web.

  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