Comment : lancer une application autonome avec le profileur et collecter des statistiques d'applications en utilisant la ligne de commande

Cette rubrique décrit comment utiliser les outils en ligne de commande des outils de profilage Visual Studio pour démarrer une application autonome (cliente) et collecter des statistiques de performance à l'aide de la méthode d'échantillonnage.

Une session de profilage se compose de trois parties :

• démarrage de l'application à l'aide du profileur ;

• contrôle de la collecte des données ;

• fin de la session de profilage.

Démarrage de l'application avec le profileur

Pour démarrer une application cible avec le profileur, utilisez les options /start et /launch pour initialiser le profileur et démarrer l'application. Vous pouvez spécifier /start et /launch et leurs options respectives sur une ligne de commande unique.

Vous pouvez également ajouter l'option /globaloff pour suspendre la collecte de données au démarrage de l'application cible. Vous utilisez alors /globalon pour commencer à collecter des données.

Pour démarrer l'application à l'aide du profileur

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

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

   Option	Description
   /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).

3. Démarrez l'application cible. Tapez :**VSPerfCmd /launch:**appName [Options] [Sample Event]

   Vous pouvez utiliser une ou plusieurs des options suivantes avec l'option /launch.

   Option	Description
   /args:Arguments	Spécifie une chaîne qui contient les arguments de ligne de commande à passer à l'application cible.
   /console	Démarre l'application en ligne de commande cible dans une fenêtre séparée.

   Par défaut, les données de performance sont échantillonnées après 10 millions de cycles d'horloge ininterrompus. Cela correspond approximativement à une fois toutes les 10 secondes sur un processeur cadencé à 1 GHz. Vous pouvez spécifier l'une des options 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.

Contrôle de la collecte de données

Lorsque l'application cible 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 de données du profileur à 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 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 l'ID de processus (PID).
  /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, le profileur doit être détaché de tout processus profilé et le profileur doit être arrêté explicitement. Vous pouvez détacher le profileur d'une application qui a été profilée via la méthode d'échantillonnage en fermant l'application ou en appelant l'option VSPerfCmd /detach. Vous appelez alors l'option VSPerfCmd /shutdown pour arrêter le profileur et fermer le fichier de données de profilage. La commande VSPerfClrEnv /off désactive les variables d'environnement de profilage.

Pour terminer une session de profilage

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

   • Fermez l'application cible.

     ou

   • Tapez VSPerfCmd /detach

2. Arrêtez le profileur. Tapez :

   VSPerfCmd /shutdown

Voir aussi

Concepts

Profilage d'applications autonomes à partir de la ligne de commande

Autres ressources

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