VSPerfReport
Mise à jour : novembre 2007
L'outil de ligne de commande VSPerfReport permet de créer des rapports à l'aide des fichiers de données de profilage des outils de profilage Visual Studio Team System Developer. 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.
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 - le rapport contient des relations parent/enfant entre les fonctions. Function - le rapport contient des fonctions appelées. Module - le rapport contient des modules profilés. CallTree - le rapport contient la hiérarchie des fonctions appelées. Thread - le rapport contient des threads profilés. Process - le rapport contient des processus profilés. Type- le rapport contient des types alloués. Header- le rapport contient des informations d'en-tête de fichier. Mark- le rapport contient toutes les marques. Counter - le rapport contient toutes les marques ainsi que les valeurs de compteur. Ip - le rapport contient les données profilées des instructions. Life - le rapport contient la durée de vie des objets alloués (disponible lorsque les données d'allocation ont été collectées.) Line - le rapport contient la donnée de profil de la ligne du code source. |
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 compressés d'un fichier de rapport. |
SYMBOLPATH:path |
Emplacement des symboles. |
DEBUGSYMPATH |
Débogue les emplacements où les recherches de symboles sont effectuées. |
PACKSYMBOLS |
Compresse les symboles dans le fichier de rapport après l'analyse. |
OUTPUT:chemin_accès|nom_fichier |
Emplacement du fichier de rapport. |
SUMMARYFILEe |
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é. |
PRINTMARKS |
Le rapport contient les noms et les horodatages pour toutes les marques. |
? |
Affiche les informations d'utilisation. |
NOLOGO |
Masque les informations de version lors de l'exécution du rapport. |
Options de filtre
Le tableau suivant décrit les options permettant de filtrer les données disponibles.
Options |
Description |
|---|---|
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). |
MSFILTER:[heure_début,durée] |
Affiche uniquement les données de STARTTIME jusqu'à la fin de la durée (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 |
Compare deux fichiers de rapports (.vsp ou .vsps). Les options de résumé sont ignorées à l'aide de l'option diff. |
DIFFTHRESHOLD:[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 le tableau des fonctions. |
DIFFCOLUMN:[nom_colonne] |
Utilise cette colonne spécifique pour comparer des valeurs. La valeur par défaut est la colonne des exemples exclusifs de pourcentage. |
QUERYDIFFTABLES |
Affiche les tables et colonnes valides pour les deux fichiers de rapports fournis. |