VSPerfReport

Narzędzie wiersza polecenia VSPerfReport służy do tworzenia raportów przy użyciu narzędzia profilowania plików danych Visual Studio profilowania. Domyślny format raportu to . plik csv.

VsPerfReport używa następującej składni:

VSPerfReport [/U] vspfilename [/options]

Należy filename pamiętać, że musi to być prawidłowy obiekt .vsp lub . plik vsps.

Narzędzie wiersza polecenia VSPerfReport służy również do porównywania . vsp lub . pliki vsps. Aby wygenerować raport różnicy ("różnicowy"), użyj następującej składni:

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

vspfilename1 and vspfilename2musi być prawidłowy. vsp lub . pliki vsps.

Pliki symboli

Aby wyświetlić informacje o symbolach, takie jak nazwy funkcji i numery wiersza, vsPerfReport wymaga dostępu do symbolu (. PLIKI PDB) profilowane składniki i do Windows plików symboli. Aby uzyskać więcej informacji, zobacz Jak określić lokalizacje plików symboli z wiersza polecenia.

Ogólne opcje raportu

W poniższej tabeli opisano ogólne opcje formatowania raportu i opcje wybierania danych do zgłoszenia.

Opcje Opis
U Dane wyjściowe raportu i przekierowane dane wyjściowe konsoli są zapisywane jako Unicode. Musi to być pierwsza określona opcja.
Podsumowanie:[typy] Tworzy co najmniej jeden typ raportów.

- All — generowane są wszystkie typy raportów.
- CallerCallee — relacje nadrzędny/podrzędny między funkcjami.
- Function — wywoływane funkcje.
- CallTree — wywoływana hierarchia funkcji.
- Counter— wszystkie znaczniki wraz Windows wartości licznika wydajności.
- Ip — profilowane instrukcje.
- Life — okres istnienia przydzielonych obiektów (dostępne, gdy zbierane są dane alokacji).
- Line dane profilu wiersza kodu źródłowego.
- Header — raport zawiera informacje o nagłówku pliku.
- Mark wszystkie znaczniki.
- Module — profile modułów.
- Process — profilowane procesy.
- Thread — wątki profilowane.
- Type — przydzielone typy.
- Contention — skwedy o zasoby.
- RuleWarnings — problemy z regułami wydajności
- ETW— wszystkie zdarzenia śledzenia zdarzeń Windows (ETW) zebrane w przebiegu profilowania. Plik danych etl musi znajdować się w oryginalnej lokalizacji lub w katalogu zawierającym plik vsp lub vsps.
Xml Raport wyjściowy w formacie XML.
Calltrace Tworzy listę wpisów i wyjść funkcji, zdarzeń ETW i znaczników.
ClearPackedSymbols Usuwa wcześniej osadzone symbole z pliku danych profilera. Uruchom to polecenie przed uruchomieniem packSymbols po raz drugi.
SymbolPath:path Określa co najmniej jedną ścieżkę wyszukiwania lub serwery symboli, które zawierają symbole dla pliku danych profilera.
DebugSymPath Wyświetla listę lokalizacji, w których wyszukiwane są symbole, oraz informacje o tym, czy zostały znalezione. Ta opcja jest przydatna do rozwiązywania problemów z rozwiązywaniem symboli.
PackSymbols Zapisuje symbole w pliku danych profilowania (vsp), tak aby symbol (.pliki pdb) nie są wymagane do analizy.
Dane wyjściowe: ścieżka|nazwa pliku Określa alternatywną lokalizację dla wygenerowanych plików raportu. Domyślnie raporty są tworzone w bieżącym katalogu.
SummaryFile Przeanalizuj i zapisz analizowane informacje w pliku podsumowania vsps.
PrintMarks Pokaż nazwy i znaczniki czasu dla wszystkich znaczników w określonym pliku raportu.
? Wyświetla informacje o użyciu.
NoLogo Ukrywa informacje o wersji, gdy raport jest uruchomiony.
UserRulesDirectory Określa katalog zawierający reguły wydajności zdefiniowane przez użytkownika [jeszcze nie zaimplementowane].

Opcje filtru

W poniższej tabeli opisano opcje filtrowania dostępnych danych.

Opcje Opis
JustMyCode[:[ caller ][, callee ]] Pokaż tylko wywołania funkcji aplikacji użytkownika; Ukryj wywołania systemowe.

- Brak parametrów — ukrywa wszystkie funkcje systemowe.
- caller — pokazuje jeden poziom funkcji systemowych, które wywołują funkcje aplikacji.
- callee — pokazuje jeden poziom funkcji systemowych, które są wywoływane przez funkcje aplikacji użytkownika.
StartTime:[value] Pokaż tylko dane zebrane po wartości (w milisekundach).
EndTime:[value] Pokaż tylko dane zebrane przed wartością (w milisekundach).
FilterFile:VSPFFile Określa lokalizację pliku filtru, który został wygenerowany z Visual Studio raportu wydajności.
MsFilter:[starttime, duration] Pokaż tylko dane starttime od do długości duration (w milisekundach).
Proces:[pid] Pokaż tylko dane z określonego procesu.
Wątek:[threadid] Pokaż tylko dane z określonego wątku.
Wątek:[threadid, processid] Pokaż tylko dane z określonego wątku skojarzonego z określonym procesem.

Opcje raportu różnic

W poniższej tabeli opisano opcje porównywania plików raportu.

Opcje Opis
Diff vspfile1 vspfile2 Porównaj dwa pliki raportu (.vsp lub . vsps) Pliki. Opcje podsumowania zostaną zignorowane przy użyciu opcji różnicy.
Różnica:[wartość] Poniżej tej wartości progowej różnica między dwiema wartościami zostanie zignorowana. Ponadto nowe dane z wartościami poniżej tego progu nie będą wyświetlane.
DiffTable:[nazwa_tabeli] Użyj tej konkretnej tabeli, aby porównać pliki. Wartością domyślną jest tabela funkcji.
DiffColumn:[nazwakolumny] Użyj tej konkretnej kolumny do porównywania wartości. Wartość domyślna to kolumna procentu wyłącznych próbek.
QueryDiffTables Wymień prawidłowe tabele i kolumny dla dwóch dostarczonych plików raportu.

Zobacz też