Procédure pas à pas : profilage de la ligne de commande à l’aide de l’échantillonnageWalkthrough: Command-line profiling using sampling

Cette procédure pas à pas montre comment profiler une application à l’aide d’outils en ligne de commande et de l’échantillonnage pour identifier les problèmes de performances.This walkthrough demonstrates how to profile an application by using command-line tools and sampling to identify performance problems.

Dans cette procédure pas à pas, vous allez voir comment profiler une application managée à l’aide d’outils de ligne de commande et utiliser l’échantillonnage pour isoler et identifier les problèmes de performances de l’application.In this walkthrough, you will step through the process of profiling a managed application by using command-line tools, and use sampling to isolate and identify performance problems in the application.

Dans cette procédure pas à pas, vous allez suivre les étapes suivantes :In this walkthrough, you will follow these steps:

  • Profiler une application à l’aide d’outils en ligne de commande et de l’échantillonnageProfile an application by using command line tools and sampling.
  • Analyser les résultats de profilage échantillonnés pour rechercher et résoudre les problèmes de performances.Analyze sampled profiling results to locate and fix performance issues.

PrérequisPrerequisites

  • Compréhension intermédiaire de Visual C#Visual C#Intermediate understanding of Visual C#Visual C#
  • Compréhension intermédiaire de l’utilisation des outils en ligne de commandeIntermediate understanding of working with command line tools
  • Une copie de l’exemple PeopleTraxA copy of the PeopleTrax Sample
  • Pour utiliser les informations fournies par le profilage, il est préférable de disposer des informations de symboles de débogage.To work with the information provided by profiling, it is best to have debugging symbol information available.

Profilage en ligne de commande suivant la méthode par échantillonnageCommand line profiling using the sampling method

L’échantillonnage est une méthode de profilage par laquelle un processus spécifique est périodiquement interrogé pour déterminer la fonction active.Sampling is a profiling method by which a specific process is periodically polled to determine the active function. Les données résultantes fournissent le nombre de fois que la fonction était sur la pile des appels quand le processus a été échantillonné.The resulting data provides a count of how frequently the function was on top of the call stack when the process was sampled.

Note

Les outils en ligne de commande des Outils de profilage se trouvent dans le sous-répertoire \Team Tools\Performance Tools du répertoire d’installation de Visual Studio.Command-line tools of the Profiling Tools are located in the \Team Tools\Performance Tools subdirectory of the Visual Studio installation directory. Les versions 64 bits et 32 bits des outils sont disponibles sur les ordinateurs 64 bits.On 64 bit computers, both 64 bit and 32 bit versions of the tools are available. Pour utiliser les outils en ligne de commande du profileur, vous devez ajouter le chemin à la variable d’environnement PATH dans la fenêtre d’invite de commandes, ou l’ajouter à la commande.To use the profiler command-line tools, you must add the path to the PATH environment variable of the command prompt window or add it to the command itself. Pour plus d’informations, consultez Spécification du chemin d’accès aux outils en ligne de commande.For more information, see Specifying the Path to Command Line Tools. PeopleTrax est une application 32 bits.PeopleTrax is a 32-bit application.

Pour profiler l’application PeopleTrax à l’aide de la méthode d’échantillonnageTo profile the PeopleTrax application by using the sampling method

  1. Installez l’exemple d’application PeopleTrax et générez la version Release de l’application.Install the PeopleTrax sample application and build the release version of the application.

  2. Ouvrez une fenêtre d’invite de commandes et ajoutez le répertoire Outils de profilage à la variable d’environnement Path locale.Open a command prompt window and add the Profiling Tools directory to the local Path environment variable.

  3. Définissez le répertoire de travail sur le répertoire contenant les binaires PeopleTrax.Change the working directory to the directory that contain the PeopleTrax binaries.

  4. Tapez la commande suivante pour définir les variables d’environnement appropriées :Type the following command to set the appropriate environment variables:

    VSPerfCLREnv /sampleon
    
  5. Démarrez le profilage en exécutant VSPerfCmd.exe, outil en ligne de commande qui contrôle le profileur.Start profiling by running VSPerfCmd.exe, which is the command-line tool that controls the profiler. La commande suivante démarre l’application et le profileur en mode d’échantillonnage :The following command starts the application and profiler in the sampling mode:

    VsPerfCmd /start:sample /output:PeopleTraxReport.vsp /launch:PeopleTrax.exe
    

    Le processus du profileur démarre et s’attache au processus PeopleTrax.exe.The profiler process starts and attaches to the PeopleTrax.exe process. Le processus du profileur commence à écrire les données de profilage collectées dans le fichier de rapport.The profiler process starts to write the collected profiling data to the report file.

  6. Cliquez sur Get People (Obtenir des personnes).Click Get People.

  7. Cliquez sur Exporter les données.Click ExportData.

    Le Bloc-notes s’ouvre et affiche un nouveau fichier qui contient les données exportées à partir de PeopleTrax.Notepad opens and displays a new file that contains the exported data from PeopleTrax.

  8. Fermez le Bloc-notes, puis l’application PeopleTrax.Close Notepad, and then close the PeopleTrax application.

  9. Fermez le profileur.Shut down the profiler. Tapez la commande suivante :Type the following command:

    VSPerfCmd /shutdown
    
  10. Utilisez la commande suivante pour redéfinir les variables d’environnement :Use the following command to reset the environmental variables:

    VSPerfCLREnv /sampleoff
    
  11. Les données de profilage sont stockées dans le fichier .vsp. Analysez les résultats à l’aide de l’une des méthodes suivantes :Profiling data is stored in the .vsp file Analyze the results by using one of the following methods:

    • Ouvrez le fichier .vsp dans l’IDE Visual Studio.Open the .vsp file in the Visual Studio IDE.

      — ou —— or —

    • Générez un fichier de valeurs séparées par des virgules (.csv) à l’aide de l’outil en ligne de commande VSPerfReport.exe.Generate a comma-separated value (.csv) file by using the command-line tool VSPerfReport.exe. Pour générer des rapports pour une utilisation en dehors de l’IDE de Visual StudioVisual Studio, utilisez la commande suivante :To generate reports for use outside the Visual StudioVisual Studio IDE use the following command:

      VSPerfReport <dir> PeopleTraxReport.vsp /output:<dir> /summary:all
      

Voir aussiSee also

Vue d’ensemble de la session de performancePerformance session overview
Profiler à partir de la ligne de commandeProfile from the command-line
VSPerfCmdVSPerfCmd
Fonctionnement des valeurs de données d’échantillonnageUnderstand sampling data values
Vues du rapport des performancesPerformance report views