Comment : attacher le profileur à une application Web ASP.NET pour collecter des statistiques d'applications en utilisant la ligne de commande

Cette rubrique explique comment utiliser les outils en ligne de commande des outils de profilage Visual Studio pour attacher le profileur à une application Web ASP.NET et collecter des statistiques de performance à l'aide de la méthode d'échantillonnage.

Pour collecter les données de performance d'une application Web ASP.NET, les variables d'environnement appropriées doivent être initialisées et l'ordinateur qui héberge l'application Web ASP.NET doit être redémarré pour configurer le serveur Web en vue du profilage.

Vous attachez alors le profileur au processus de travail ASP.NET qui héberge votre site Web. Une fois le profileur attaché à l'application, vous pouvez suspendre la collecte de données et la reprendre.

Pour terminer une session de profilage, le profileur doit être détaché de l'application profilée et le profileur doit être arrêté explicitement. Dans la plupart des cas, nous vous recommandons de désactiver les variables d'environnement de profilage à la fin d'une session.

Démarrage du profileur et attachement à une application Web ASP.NET

Pour attacher le profileur à une application Web ASP.NET

1. Ouvrez une fenêtre d'invite de commandes.

2. Initialisez les variables d'environnement de profilage. Type :

   VSPerfClrEnv /globalsampleon [/samplelineoff]

   • /globalsampleon active l'échantillonnage.

   • /samplelineoff désactive l'assignation des données collectées à des lignes de code source spécifiques. Lorsque cette option est spécifiée, les données sont assignées uniquement aux fonctions.

3. Redémarrez l'ordinateur.

4. Démarrez le profileur. Tapez :VSPerfCmd /start:sample /output**:**OutputFile[Options]

   • L'option /start:sample initialise le profileur.

   • L'option **/output:**OutputFile est requise avec /start. OutputFile spécifie le nom et l'emplacement du fichier de données de profilage (.vsp).

   Vous pouvez utiliser n'importe laquelle des options suivantes avec l'option /start:sample.

   Notes

   Les options /user et /crosssession sont généralement requises pour les applications ASP.NET.

   Option	Description
   /user:[Domain\]UserName	Spécifie le domaine et le nom d'utilisateur du compte qui possède le processus de travail ASP.NET. Cette option est requise si le processus s'exécute en tant qu'utilisateur autre que l'utilisateur connecté. Le propriétaire du processus est répertorié dans la colonne Nom d'utilisateur sous l'onglet Processus du Gestionnaire des tâches de Windows.
   /crosssession	Active le profilage de processus dans d'autres ouvertures de session. Cette option est requise si l'application ASP.NET s'exécute dans une session différente. L'identificateur de session est répertorié dans la colonne Identificateur de session sous l'onglet Processus du Gestionnaire des tâches de Windows. /CS peut être spécifié en tant qu'abréviation de /crosssession.
   /wincounter:WinCounterPath	Spécifie un compteur de performance Windows à collecter au cours du profilage.
   /automark:Interval	À n'utiliser qu'avec /wincounter. Spécifie le nombre de millisecondes entre les événements de collecte du compteur de performance Windows. La valeur par défaut est de 500 ms.
   /events:Config	Spécifie un événement ETW (Event Tracing for Windows) à collecter au cours du profilage. Les événements ETW sont collectés dans un fichier séparé (.etl).

5. Démarrez l'application Web ASP.NET de la manière classique.

6. Attachez le profileur au processus de travail ASP.NET. Tapez :VSPerfCmd /attach:{PID |ProcName} [Sample Event] [/targetclr**:**Version]

   • PID spécifie l'ID du processus de travail ASP.NET ; ProcName spécifie le nom du processus de travail. Vous pouvez afficher les ID et les noms de processus de tous les processus en cours d'exécution dans le Gestionnaire des tâches de Windows.

   • Par défaut, les données de performance sont échantillonnées après 10 millions de cycles d'horloge ininterrompus. Cela correspond à environ 100 fois par seconde sur un processeur cadencé à 1 GHz. Vous pouvez spécifier l'une des options VSPerfCmd suivantes pour modifier l'intervalle de cycle d'horloge ou pour spécifier un événement d'échantillonnage différent.

   Événement d'échantillonnage	Description
   /timer:Interval	Remplace l'intervalle d'échantillonnage par le nombre de cycles d'horloge ininterrompus spécifié par Interval.
   /pf[:Interval]	Change l'événement d'échantillonnage en erreurs de page. Si Interval est spécifié, définit le nombre d'erreurs de page entre les exemples. La valeur par défaut est 10.
   /sys[:Interval]	Change l'événement d'échantillonnage en appels système du processus au noyau du système d'exploitation (syscalls). Si Interval est spécifié, définit le nombre d'appels entre les exemples. La valeur par défaut est 10.
   /counter:Config	Remplace l'événement et l'intervalle d'échantillonnage par le compteur de performance de processeur et l'intervalle spécifiés dans Config.
   /targetclr:Version	Spécifie la version du Common Language Runtime (CLR) à profiler lorsque plusieurs versions du runtime sont chargées dans une application.

   • **targetclr:**Version spécifie la version du Common Language Runtime (CLR) à profiler lorsque plusieurs versions du runtime sont chargées dans une application. Facultatif.

Contrôle de la collecte de données

Lorsque l'application s'exécute, vous pouvez contrôler la collecte de données en démarrant et en arrêtant l'écriture de données dans le fichier à l'aide des options VSPerfCmd.exe. Le contrôle de la collecte de données vous permet de collecter des données pour une partie spécifique de l'exécution du programme, notamment le démarrage ou l'arrêt de l'application.

Pour démarrer et arrêter la collecte de données

• Les paires suivantes d'options VSPerfCmd démarrent et arrêtent la collecte de données. Spécifiez chaque option sur une ligne de commande séparée. Vous pouvez activer et désactiver la collecte de données à plusieurs reprises.

  Option	Description
  /globalon /globaloff	Démarre (/globalon) ou arrête (/globaloff) la collecte de données pour tous les processus.
  /processon:PID /processoff:PID	Démarre (/processon) ou arrête (/processoff) la collecte de données pour le processus spécifié par PID (l'ID de processus).
  /attach:{PID|ProcName} /detach[:{PID|ProcName}]	/attach commence à collecter des données pour le processus spécifié par le PID (ID de processus) ou le nom de processus (ProcName). /detach arrête la collecte de données pour le processus spécifié ou pour tous les processus si aucun processus n'est spécifié.

• Vous pouvez également utiliser l'option VSPerfCmd.exe /mark pour insérer une marque de profilage dans le fichier de données. La commande /mark ajoute un identificateur, un horodatage et une chaîne de texte facultative définie par l'utilisateur. Les marques peuvent servir à filtrer les données dans les rapports et les vues de données du profileur.

Fin de la session de profilage

Pour terminer une session de profilage, fermez l'application Web ASP.NET, puis utilisez la commande des services IIS (Internet Information Services) IISReset pour fermer le processus de travail ASP.NET. Appelez l'option VSPerfCmd /shutdown pour arrêter le profileur et fermer le fichier de données de profilage.

La commande VSPerfClrEnv /globaloff désactive les variables d'environnement de profilage. Vous devez redémarrer l'ordinateur pour que les nouveaux paramètres d'environnement soient appliqués.

La commande VSPerfClrEnv /globaloff désactive les variables d'environnement de profilage, mais la configuration du système n'est réinitialisée qu'au redémarrage de l'ordinateur.

Pour terminer une session de profilage

1. Effectuez l'une des opérations suivantes pour détacher le profileur de l'application cible :

   • Tapez VSPerfCmd /detach

     ou

   • Fermez le processus de travail ASP.NET.

2. Arrêtez le profileur. Tapez :VSPerfCmd /shutdown

3. (Facultatif) Désactivez les variables d'environnement de profilage. Type :

   VSPerfCmd /globaloff

4. Redémarrez l'ordinateur.

Voir aussi

Concepts

Profilage d'applications Web ASP.NET à partir de la ligne de commande

Autres ressources

Vues de données de la méthode d'échantillonnage du profileur