VSPerfReport

Article
03/04/2013

L'outil de ligne de commande VSPerfReport permet de créer des rapports à l'aide des fichiers de données des outils de profilage Visual Studio.Le format de rapport par défaut est un fichier .csv.

VSPerfReport utilise la syntaxe suivante :

VSPerfReport [/U] vspfilename [/options]

Notez que filename doit correspondre à un fichier .vsp ou .vsps valide.

L'outil de ligne de commande VSPerfReport est également utilisé pour comparer des fichiers .vsp ou .vsps.Pour générer un rapport des différences ("diff"), utilisez la syntaxe suivante :

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

vspfilename1 and vspfilename2 doivent correspondre à des fichiers .vsp ou .vsps valides.

Fichiers de symboles

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.Pour plus d’informations, consultez Comment : spécifier les emplacements du fichier de symboles à partir de la ligne de commande.

Options de rapport générales

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.

Options	Description
U	La sortie du rapport et la sortie de la console redirigée sont écrites sous Unicode.Doit être la première option spécifiée.
Summary:[types]	Crée un ou plusieurs types de rapports. All - tous les types de rapport sont générés. CallerCallee- relations parent/enfant entre les fonctions. Function- fonctions appelées. CallTree- hiérarchie des fonctions appelées. Counter - toutes les marques ainsi que les valeurs de compteur de performance Windows. Ip- instructions profilées. Life - durée de vie des objets alloués (disponible lorsque les données d'allocation ont été collectées.) Line données de profil de la ligne du code source. Header- le rapport contient des informations d'en-tête de fichier. Mark toutes les marques. Module - modules profilés. Process - processus profilés. Thread - threads profilés. Type - types alloués. Contention - contentions de ressource. RuleWarnings - problèmes de règles de performance ETW - tous les événements ETW (Event Tracing for Windows) collectés dans l'exécution du profilage.Le fichier de données .etl doit être à son emplacement d'origine ou dans le répertoire qui contient le fichier .vsp ou .vsps.
Xml	Rapport de sortie au format XML.
CallTrace	Crée une liste d'entrées des fonctions et quitte le programme, des événements ETW et des marques.
ClearPackedSymbols	Supprime les symboles précédemment incorporés d'un fichier de données du profileur.Exécutez cette commande avant d'exécuter PackSymbols une deuxième fois.
SymbolPath: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.
DebugSymPath	Répertorie les emplacements dans lesquels des symboles sont recherchés et indique si des symboles sont trouvés.Cette option est utile pour résoudre les problèmes de résolution de symboles.
PackSymbols	Enregistre les symboles dans le fichier de données de profilage (.vsp) afin que les fichiers de symboles (.pdb) ne soient pas nécessaires pour l'analyse.
Output:path\|filename	Spécifie un autre emplacement pour les fichiers de rapport générés.Par défaut, les rapports sont créés dans le répertoire actif.
SummaryFile	Analyse et enregistre les informations analysées dans un fichier de résumé .vsps.
PrintMarks	Indique les noms et les horodatages pour toutes les marques du fichier de rapport spécifié.
?	Affiche les informations d'utilisation.
NoLogo	Masque les informations de version lors de l'exécution du rapport.
UserRulesDirectory	Indique le répertoire qui contient les règles de performance définies par l'utilisateur [Non implémenté pour le moment].

Options de filtre

Le tableau suivant décrit les options permettant de filtrer les données disponibles.

Options	Description
JustMyCode[:[caller][,callee]]	Affiche uniquement les appels de fonction d'application utilisateur et masque les appels système. Aucun paramètre - masque toutes les fonctions système. caller - affiche un niveau de fonctions système qui appellent des fonctions d'application. callee- affiche un niveau de fonctions système appelées par les fonctions d'application utilisateur.
StartTime:[valeur]	Affiche uniquement les données collectées après la valeur (en millisecondes).
EndTime:[valeur]	Affiche uniquement les données collectées avant la valeur (en millisecondes).
FilterFile:VSPFFile	Spécifie l'emplacement d'un fichier filtre qui a été généré depuis la fenêtre Rapport de performances de Visual Studio.
MsFilter:[heure_début,durée]	Affiche uniquement les données de starttime jusqu'à la fin de la durée (duration) en millisecondes.
Process:[pid]	Affiche uniquement les données du processus spécifié.
Thread:[ID_thread]	Affiche uniquement les données du thread spécifié.
Thread:[ID_thread,ID_processus]	Affiche uniquement les données du thread spécifié associé au processus spécifié.

Options du rapport des différences

Le tableau suivant décrit les options disponibles pour comparer des fichiers de rapport.

Options	Description
Diff vspfile1 vspfile2	Compare deux fichiers de rapports (.vsp ou .vsps).Les options de résumé sont ignorées à l'aide de l'option diff.
Diff:[valeur]	Au-dessous de cette valeur de seuil, la différence entre deux valeurs est ignorée.De même, les nouvelles données avec des valeurs en dessous de ce seuil ne sont pas affichées.
DiffTable:[nom_table]	Utilise ce tableau spécifique pour comparer des fichiers.La valeur par défaut est la table des fonctions.
DiffColumn:[nom_colonne]	Utilise cette colonne spécifique pour comparer des valeurs.La valeur par défaut est la colonne de pourcentage d'échantillons exclusifs.
QueryDiffTables	Affiche les tables et colonnes valides pour les deux fichiers de rapports fournis.

Voir aussi

Autres ressources

Vues des rapports d'outils de profilage