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. |