VSPerfReportVSPerfReport

L’outil en ligne de commande VSPerfReport permet de créer des rapports à l’aide des fichiers de données des outils de profilage Visual StudioVisual Studio.VSPerfReport command line tool is used to create reports using Visual StudioVisual Studio Profiling Tools profiling data files. Le format de rapport par défaut est un fichier .csv.The default report format is a .csv file.

VSPerfReport utilise la syntaxe suivante :VSPerfReport uses the following syntax:

VSPerfReport [/U] vspfilename [/options]  

Notez que filename doit être un fichier .vsp ou .vsps valide.Note that filename must be a valid .vsp or .vsps file.

L’outil en ligne de commande VSPerfReport est également utilisé pour comparer des fichiers .vsp ou .vsps.The VSPerfReport command line tool is also used to compare .vsp or .vsps files. Pour générer un rapport de différences (« diff »), utilisez la syntaxe suivante :To generate a difference ("diff") report, use the following syntax:

VSPerfReport [/U] /diff vspfilename1 vspfilename2 [/options]  

vspfilename1 and vspfilename2 doivent être des fichiers .vsp ou .vsps valides.vspfilename1 and vspfilename2 must be valid .vsp or .vsps files.

Fichiers de symbolesSymbol Files

Pour afficher les informations de symbole telles que les noms de fonction et les numéros de ligne, VSPerfReport doit accéder aux fichiers de symboles (.PDB) des composants profilés et aux fichiers de symboles Windows.To display symbol information such as function names and line numbers, VSPerfReport requires access to the symbol (.PDB) files of the profiled components and to Windows symbol files. Pour plus d’informations, consultez Guide pratique pour spécifier les emplacements du fichier de symboles à partir de la ligne de commande.For more information, see How to: Specify Symbol File Locations from the Command Line.

Options de rapport généralesGeneral Report Options

Le tableau suivant décrit les options générales de mise en forme de rapport et les options qui sélectionnent les données devant figurer dans le rapport.The following table describes the general report formatting options and the options that select the data to be reported.

OptionsOptions DescriptionDescription
UU La sortie du rapport et la sortie de la console redirigée sont écrites au format Unicode.Report output and redirected console output are written as Unicode. Doit être la première option spécifiée.Must be the first option specified.
Summary:[types]Summary:[types] Crée un ou plusieurs types de rapports.Creates one or more types of reports.

- All : tous les types de rapport sont générés.- All - all report types are generated.
- CallerCallee : relations parent/enfant entre les fonctions.- CallerCallee - parent/child relationships between functions.
- Function : fonctions appelées.- Function - functions called.
- CallTree : hiérarchie des fonctions appelées.- CallTree - hierarchy of functions called.
- Counter : toutes les marques ainsi que les valeurs des compteurs de performances Windows.- Counter - all marks together with Windows performance counter values.
- Ip : instructions profilées.- Ip - instructions profiled.
- Life : durée de vie des objets alloués (disponible lorsque les données d’allocation ont été collectées).- Life - lifetime of allocated objects (available when allocation data has been collected.)
- Line : données de profil de la ligne du code source.- Line source code line profile data.
- Header : le rapport contient des informations d’en-tête de fichier.- Header - report contains file header information.
- Mark : toutes les marques.- Mark all marks.
- Module : modules profilés.- Module - modules profiled.
- Process : processus profilés.- Process - processes profiled.
- Thread : threads profilés.- Thread - threads profiled.
- Type : types alloués.- Type - allocated types.
- Contention : contentions de ressource.- Contention - resource contentions.
- RuleWarnings : problèmes de règles de performance.- RuleWarnings - performance rule issues
- ETW : tous les événements de suivi d’événements pour Windows (ETW) collectés dans l’exécution du profilage.- ETW - all Event Tracing for Windows (ETW) events collected in the profiling run. Le fichier de données .etl doit être à son emplacement d’origine ou dans le répertoire qui contient le fichier .vsp ou .vsps.The .etl data file must be in its original location or in the directory containing the .vsp or .vsps file.
XmlXml Rapport de sortie au format XML.Output report in XML format.
CallTraceCallTrace Crée une liste d’entrées et de sorties de fonction, d’événements ETW et de marques.Creates a list of function entry and exits, ETW events, and marks.
ClearPackedSymbolsClearPackedSymbols Supprime les symboles précédemment incorporés d’un fichier de données du profileur.Removes previously embedded symbols from a profiler data file. Exécutez cette commande avant d’exécuter PackSymbols une deuxième fois.Run this command before running PackSymbols a second time.
SymbolPath: pathSymbolPath: path Spécifie un ou plusieurs chemins de recherche ou serveurs de symboles qui contiennent les symboles pour le fichier de données du profileur.Specifies one or more search paths or symbol servers that contain symbols for the profiler data file.
DebugSymPathDebugSymPath Répertorie les emplacements dans lesquels la recherche des symboles est effectuée et indique si des symboles sont trouvés.Lists the locations that are searched for symbols and whether they are found. Cette option est utile pour résoudre les problèmes de résolution de symboles.This option is useful to resolve symbol resolution issues.
PackSymbolsPackSymbols Enregistre les symboles dans le fichier de données de profilage (.vsp) pour que les fichiers de symboles (.pdb) ne soient pas nécessaires pour l’analyse.Saves symbols into the profiling data (.vsp) file so that symbol (.pdb) files are not required for analysis.
Output: chemin|nom_fichierOutput: path|filename Spécifie un autre emplacement pour les fichiers de rapport générés.Specifies an alternate location for the generated report files. Par défaut, les rapports sont créés dans le répertoire actif.By default, reports are created in the current directory.
SummaryFileSummaryFile Analyse et enregistre les informations analysées dans un fichier de résumé .vsps.Analyze and save the analyzed information in a .vsps summary file.
PrintMarksPrintMarks Indique les noms et les horodatages pour toutes les marques du fichier de rapport spécifié.Show the names and timestamps for all marks in the specified report file.
?? Affiche les informations d’utilisation.Displays usage information.
NoLogoNoLogo Masque les informations de version durant l’exécution du rapport.Hides version information when the report is running.
UserRulesDirectoryUserRulesDirectory Spécifie le répertoire qui contient les règles de performance définies par l’utilisateur [pas encore implémenté].Specifies directory containing user-defined performance rules [Not yet implemented].

Options du filtreFilter Options

Le tableau suivant décrit les options permettant de filtrer les données disponibles.The following table describes the options to filter the available data.

OptionsOptions DescriptionDescription
JustMyCode[:[caller][,callee]]JustMyCode[:[caller][,callee]] Affiche uniquement les appels de fonction d’application utilisateur et masque les appels système.Only show user application function calls; hide system calls.

- Aucun paramètre : masque toutes les fonctions système.- No parameters - hide all system functions.
- caller : affiche un niveau de fonctions système qui appellent des fonctions d’application.- caller - show one level of system functions that call application functions.
- callee : affiche un niveau de fonctions système appelées par les fonctions d’application utilisateur.- callee - show one level of system functions that are called by user application functions.
StartTime:[value]StartTime:[value] Affiche uniquement les données collectées après la valeur (en millisecondes).Only show data collected after value (in milliseconds.)
EndTime:[value]EndTime:[value] Affiche uniquement les données collectées avant la valeur (en millisecondes).Only show data collected before value (in milliseconds.)
FilterFile: VSPFFileFilterFile: VSPFFile Spécifie l’emplacement d’un fichier filtre qui a été généré à partir de la fenêtre Rapport de performances de Visual Studio.Specifies the location of a filter file that was generated from the Visual Studio Performance Report window.
MsFilter:[starttime,duration]MsFilter:[starttime,duration] Affiche uniquement les données de starttime jusqu’à la fin de duration (en millisecondes).Only show data from starttime until the length of duration (in milliseconds.)
Process:[pid]Process:[pid] Affiche uniquement les données du processus spécifié.Only show data from the specified process.
Thread:[threadid]Thread:[threadid] Affiche uniquement les données du thread spécifié.Only show data from the specified thread.
Thread:[threadid,processid]Thread:[threadid,processid] Affiche uniquement les données du thread spécifié associé au processus spécifié.Only show data from the specified thread associated with the specified process.

Options du rapport des différencesDifference Report Options

Le tableau suivant décrit les options disponibles pour comparer des fichiers de rapport.The following table describes the options for comparing report files.

OptionsOptions DescriptionDescription
Diff vspfile1 vspfile2Diff vspfile1 vspfile2 Compare deux fichiers de rapports (.vsp ou .vsps).Compare two report files (.vsp or .vsps) files. Les options de résumé sont ignorées à l’aide de l’option diff.Summary options will be ignored using the diff option.
Diff:[value]Diff:[value] Au-dessous de cette valeur de seuil, la différence entre deux valeurs est ignorée.Below this threshold value the difference between two values will be disregarded. De même, les nouvelles données avec des valeurs en dessous de ce seuil ne sont pas affichées.Also, new data with values under this threshold will not be shown.
DiffTable:[tablename]DiffTable:[tablename] Utilise cette table spécifique pour comparer des fichiers.Use this specific table to compare files. La valeur par défaut est la table des fonctions.The default is the functions table.
DiffColumn:[columnname]DiffColumn:[columnname] Utilise cette colonne spécifique pour comparer des valeurs.Use this specific column compare values. La valeur par défaut est la colonne de pourcentage d’échantillons exclusifs.The default is the exclusive samples percent column.
QueryDiffTablesQueryDiffTables Affiche les tables et colonnes valides pour les deux fichiers de rapports fournis.List the valid tables and columns for the two report files provided.

Voir aussiSee Also

Vues Rapport de performancesPerformance Report Views