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
- Une application Azure App Services ASP.NET/ASP.NET Core.
- Ressource Application Insights connectée à votre application App Service.
Vérifiez que le paramètre « Always On » est activé
Dans le portail Azure, accédez à votre application App Service.
Sous Paramètres dans le menu de gauche, sélectionnez Configuration.
Sélectionnez l’onglet Paramètres généraux.
Vérifiez que Always On>On est sélectionné.
Si vous avez effectué des modifications, sélectionnez Enregistrer.
Activer Application Insights et Profiler
Dans le menu de gauche, sous Paramètres, sélectionnez Application Insights.
Sous Application Insights, sélectionnez Activer.
Vérifiez que vous avez connecté une ressource Application Insights à votre application.
Faites défiler vers le bas et sélectionnez l’onglet .NET ou .NET Core, selon votre application.
Vérifiez que le Niveau de la collection>Recommandé est sélectionné.
Sous Profiler, sélectionnez On.
- Si vous avez choisi le niveau de collection Basic précédemment, le paramètre Profiler est désactivé.
Sélectionnez Appliquer, puis Oui pour confirmer.
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 :
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
Configurez et activez Azure AD dans votre ressource Application Insights.
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 :
Sous Paramètres dans le menu de gauche, sélectionnez WebJobs.
Sélectionnez la tâche web nommée
ApplicationInsightsProfiler3.Cliquez sur Stop dans le menu supérieur.
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.