Sdílet prostřednictvím


Referenční informace: příkazy vcperf

Nástroje C++ Build Insights jsou dostupné od sady Visual Studio 2019 a novější. Pokud chcete zobrazit dokumentaci pro tuto verzi, nastavte ovládací prvek selektoru verzí sady Visual Studio pro tento článek na Visual Studio 2019 nebo novější. Nachází se v horní části obsahu na této stránce.

Tento článek uvádí a popisuje příkazy, které jsou k dispozici, vcperf.exea jak je používat.

Příkazy pro spuštění a zastavení trasování

Důležité

Pokud nezadáte /noadmin, následující příkazy vyžadují oprávnění správce.

Možnost Argumenty a popis
/start [] [/noadmin] [/level1/nocpusampling/level3 | /level2 | ]<sessionName>
Spustí trasování pod daným názvem relace.

Tato /noadmin možnost běží vcperf.exe bez oprávnění správce a tuto možnost ignoruje /nocpusampling . Když spustíte vcperf bez oprávnění správce, může na daném počítači existovat více než jedna aktivní relace.

Možnost /nocpusampling určuje , vcperf.exe neshromažďuje vzorky procesoru. Zabrání použití zobrazení Využití procesoru (vzorkované) ve Windows Analyzátor výkonu, ale zmenší shromážděné trasování.

Parametr /level1, /level2nebo /level3 možnosti určují, které události MSVC mají být shromažďovány, při zvýšení úrovně informací. Úroveň 3 zahrnuje všechny události. Úroveň 2 obsahuje všechny události kromě událostí vytváření instancí šablony. Úroveň 1 obsahuje všechny události kromě vytváření instancí šablony, funkce a událostí souborů. Pokud není zadáno, /level2 je ve výchozím nastavení vybraná.

Jakmile vcperf.exe spustí trasování, vrátí se okamžitě. Trasování shromažďuje události v celém systému pro všechny procesy spuštěné na počítači. To znamená, že projekt nemusíte sestavovat ve stejném okně příkazového řádku jako ten, který používáte ke spuštění vcperf.exe. Můžete například vytvořit projekt v sadě Visual Studio.
/stop (1) [/templates] <sessionName> <outputFile.etl>
(2) [/templates] <sessionName> /timetrace <outputFile.json>
Zastaví trasování identifikované daným názvem relace. Spustí krok následného zpracování trasování, který vygeneruje soubor určený parametrem <outputFile> .

Tato /templates možnost obsahuje události vytváření instancí šablony v souboru.

(1) Vygeneruje soubor zobrazitelný ve Windows Analyzátor výkonu (WPA). Výstupní soubor vyžaduje příponu .etl .
(2) Vygeneruje soubor zobrazitelný v prohlížeči trasování Microsoft Edge (edge://tracing). Výstupní soubor vyžaduje příponu .json .
/stopnoanalyze <sessionName> <rawOutputFile.etl>
Zastaví trasování identifikované daným názvem relace a zapíše nezpracovaná nezpracovaná data do zadaného výstupního souboru. Výsledný soubor není určený pro prohlížení v WPA.

Krok následného /stop zpracování, který je součástí příkazu, může být někdy zdlouhavý. Tento krok následného /stopnoanalyze zpracování můžete pozdržet pomocí příkazu. /analyze Příkaz použijte, když jste připraveni vytvořit soubor zobrazitelný ve Windows Analyzátor výkonu nebo prohlížeči trasování Microsoft Edge.

Různé příkazy

Možnost Argumenty a popis
/analyze (1) [/templates] <rawInputFile.etl> <outputFile.etl>
(2) [/templates] <rawInputFile.etl> /timetrace <outputFile.json>
Přijímá nezpracovaný trasovací soubor vytvořený příkazem /stopnoanalyze . Spustí krok následného zpracování tohoto trasování, který vygeneruje soubor určený parametrem <outputFile> .

Tato /templates možnost obsahuje události vytváření instancí šablony v souboru.

(1) Vygeneruje soubor zobrazitelný ve Windows Analyzátor výkonu (WPA). Výstupní soubor vyžaduje příponu .etl .

(2) Vygeneruje soubor zobrazitelný v prohlížeči trasování Microsoft Edge (edge://tracing). Výstupní soubor vyžaduje příponu .json .

Viz také

Začínáme se službou C++ Build Insights
Kurz: Základy windows Analyzátor výkonu
Referenční informace: Zobrazení windows Analyzátor výkonu
Windows Analyzátor výkonu