Activer Profiler pour les applications Azure App Service

Application Insights Profiler est préinstallé dans le cadre de l’exécution d’App Service. Vous pouvez exécuter Profiler sur des applications ASP.NET et ASP.NET Core qui s’exécutent sur Azure App Service avec le niveau de service De base ou un niveau supérieur. Suivez ces étapes même si vous avez inclus le SDK App 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.

Conditions préalables

Vérifiez que le paramètre « Always On » est activé

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

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

    Screenshot of selecting Configuration from the left side menu.

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

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

    Screenshot of the General tab on the Configuration pane and showing the Always On being enabled.

  5. Si vous avez effectué des modifications, sélectionnez Enregistrer.

Activer Application Insights et Profiler

  1. Dans le menu de gauche, sous Paramètres, sélectionnez Application Insights.

    Screenshot of selecting Application Insights from the left side menu.

  2. Sous Application Insights, sélectionnez Activer.

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

    Screenshot of enabling App 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 le 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, puis Oui pour confirmer.

    Screenshot of enabling Profiler on your app.

Activer Profiler à l’aide des paramètres d’application

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

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 à l’aide des éléments suivants :

Activer Profiler pour d’autres Clouds

Actuellement, seules les régions Azure Government et Azure Chine nécessitent 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 Azure Active Directory pour l’ingestion des profils

Application Insights Profiler prend en charge l’authentification Azure AD 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 prend en charge l’authentification Azure AD uniquement si vous référencez et configurez Azure AD en utilisant le kit de développement logiciel (SDK) Application Insights dans votre application.

Pour activer Azure AD pour l’ingestion des profils :

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

    a. Documentation relative aux identités managées affectées par le système

    b. Documentation relative aux identités managées affectées par l’utilisateur

  2. Configurez et activez Azure AD 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 menu de gauche, sélectionnez WebJobs.

    Screenshot of selecting web jobs from the left side menu.

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

  3. Cliquez sur Stop dans le menu supérieur.

    Screenshot of 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.

Les fichiers de Profiler peuvent être supprimés quand vous utilisez WebDeploy pour déployer des changements sur votre application web. Vous pouvez empêcher la suppression en excluant le dossier App_Data des éléments étant supprimés au cours du déploiement.

Étapes suivantes