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.exe
a 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 , /level2 nebo /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