Samouczek: vcperf i Windows Analizator wydajności

Z tego samouczka dowiesz się, jak zbierać vcperf.exe ślad kompilacji języka C++. Dowiesz się również, jak wyświetlić ten ślad w Analizator wydajności systemu Windows.

Krok 1. Instalowanie i konfigurowanie Analizator wydajności systemu Windows

WPA to przeglądarka śledzenia dostępna w zestawie Windows Assessment and Deployment Kit (ADK). Jest to oddzielne narzędzie, które nie jest częścią składników, które można zainstalować za pomocą instalatora programu Visual Studio.

Wersja WPA obsługującą szczegółowe informacje o kompilacji języka C++ jest dostępna tylko w wersjach zestawu Windows ADK numerowanych 10.1.19041.0 lub nowszym.

Aby pobrać i zainstalować usługę WPA

UWAGA: System Windows 8 lub nowszy jest wymagany do zainstalowania Analizator wydajności systemu Windows.

1. Przejdź do strony pobierania zestawu Windows ADK.

2. Pobierz i zainstaluj najnowszą wersję zestawu Windows ADK.

3. Po wyświetleniu monitu o funkcje, które chcesz zainstalować, wybierz zestaw narzędzi Windows Performance Toolkit. Jeśli chcesz, możesz wybrać inne funkcje, ale nie są one wymagane do zainstalowania usługi WPA.

   

Aby skonfigurować usługę WPA

Wyświetlanie śladów szczegółowych informacji o kompilacji języka C++ w usłudze WPA wymaga specjalnego dodatku. Wykonaj następujące kroki, aby go zainstalować:

1. Uzyskaj dodatek, pobierając jeden z poniższych składników. Nie musisz pobierać obu tych elementów. Wybierz ten, który znajdziesz najwygodniej.

   • Program Visual Studio 2019 w wersji 16.6 lub nowszej. Aby uzyskać najnowszą wersję, zobacz Pliki do pobrania programu Visual Studio.
   • Pakiet NuGet szczegółowych informacji o kompilacji języka C++.

2. Skopiuj plik do katalogu instalacyjnego perf_msvcbuildinsights.dll WPA.

   1. W programie Visual Studio 2019 w wersji 16.6 lub nowszej ten plik znajduje się tutaj: C:\Program Files (x86)\Microsoft Visual Studio\{Year}\{Edition}\VC\Tools\MSVC\{Version}\bin\Host{Architecture}\{Architecture}.
   2. W pakiecie NuGet build insights języka C++ ten plik znajduje się tutaj: wpa\{Architecture}.
   3. W powyższych ścieżkach zastąp zmienne otoczone nawiasami klamrowymi w następujący sposób:
      1. {Year} to rok produktu programu Visual Studio, taki jak 2019 lub 2022.
      2. {Edition} to twoja wersja programu Visual Studio, taka jak Community, Professional lub Enterprise.
      3. {Version} to twoja wersja MSVC. Wybierz najwyższą dostępną.
      4. {Architecture}: wybierz x64 , czy masz 64-bitową wersję systemu Windows. W przeciwnym razie wybierz pozycję x86.
   4. Katalog instalacyjny WPA jest zwykle: C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit.

3. W katalogu instalacyjnym perfcore.ini WPA otwórz plik i dodaj wpis dla .perf_msvcbuildinsights.dll

Krok 2. Śledzenie kompilacji przy użyciu vcperf.exe

Aby wyświetlić dane szczegółowych informacji o kompilacji języka C++, najpierw zbierz je do pliku śledzenia, wykonując następujące kroki:

1. Otwórz wiersz polecenia narzędzi natywnych x64 lub x86 dla programu VS w trybie administratora. (Kliknij prawym przyciskiem myszy element menu Start i wybierz pozycję Więcej>Uruchom jako administrator).

   1. Wybierz x64 , jeśli masz 64-bitową wersję systemu Windows. W przeciwnym razie wybierz pozycję x86.

2. W oknie wiersza polecenia wprowadź następujące polecenie:

   vcperf.exe /start SessionName

   Wybierz nazwę sesji, którą zapamiętasz w polu SessionName.

3. Skompiluj projekt tak, jak zwykle. Do skompilowania nie trzeba używać tego samego okna wiersza polecenia.

4. W oknie wiersza polecenia wprowadź następujące polecenie:

   vcperf.exe /stop SessionNametraceFile.etl

   Użyj tej samej nazwy sesji, która została wcześniej wybrana dla elementu SessionName . Wybierz odpowiednią nazwę pliku śledzenia traceFile.etl .

Oto, jak wygląda typowa sekwencja poleceń vcperf.exe w oknie wiersza polecenia dewelopera:

Ważne uwagi dotyczące vcperf.exe

• Uprawnienia administratora są wymagane do uruchomienia lub zatrzymania śledzenia vcperf.exe . Użyj okna wiersza polecenia dla deweloperów otwieranego przy użyciu polecenia Uruchom jako administrator.

• Na maszynie może być uruchamiana tylko jedna sesja śledzenia w danym momencie.

• Pamiętaj o nazwie sesji użytej do rozpoczęcia śledzenia. Może to być kłopotliwe, aby zatrzymać uruchomioną sesję bez znajomości jej nazwy.

• Podobnie jak cl.exe i link.exe, narzędzie wiersza polecenia vcperf.exe jest zawarte w instalacji MSVC. Do uzyskania tego składnika nie są wymagane żadne dodatkowe kroki.

• vcperf.exe zbiera informacje o wszystkich narzędziach MSVC uruchomionych w systemie. W związku z tym nie trzeba uruchamiać kompilacji z tego samego wiersza polecenia użytego do zbierania śladu. Projekt można utworzyć z innego wiersza polecenia, a nawet w programie Visual Studio.

vcperf.exe to open source

Jeśli chcesz skompilować i uruchomić własną wersję vcperf.exe, możesz ją sklonować z repozytorium GitHub vcperf.

Krok 3. Wyświetlanie śladu w systemie Windows Analizator wydajności

Uruchom program WPA i otwórz właśnie zebrany ślad. Usługa WPA powinna rozpoznać ją jako ślad analizy kompilacji języka C++, a w panelu Eksploratora programu Graph po lewej stronie powinny zostać wyświetlone następujące widoki:

• Eksplorator kompilacji
• Pliki
• Funkcje
• Tworzenie wystąpień szablonu

Jeśli nie widzisz tych widoków, sprawdź dokładnie, czy usługa WPA jest poprawnie skonfigurowana, zgodnie z opisem w kroku 1. Dane kompilacji można wyświetlić, przeciągając widoki do pustego okna Analiza po prawej stronie, jak pokazano poniżej:

Inne widoki są dostępne w panelu Eksplorator programu Graph. Przeciągnij je do okna Analiza, gdy interesuje Cię informacje, które zawierają. Przydatnym jest widok procesora CPU (próbkowany), który pokazuje wykorzystanie procesora CPU w całej kompilacji.

Więcej informacji

Samouczek: Podstawy Analizator wydajności systemu Windows
Dowiedz się więcej o typowych operacjach WPA, które mogą ułatwić analizowanie śladów kompilacji.

Dokumentacja: polecenia vcperf
Dokumentacja polecenia vcperf.exe zawiera listę wszystkich dostępnych opcji poleceń.

Dokumentacja: Widoki Analizator wydajności systemu Windows
Zapoznaj się z tym artykułem, aby uzyskać szczegółowe informacje na temat widoków szczegółowych informacji o kompilacji języka C++ w usłudze WPA.

Analizator wydajności systemu Windows
Oficjalna witryna dokumentacji WPA.