Справочник: команды vcperf

В этой статье перечислены и описаны команды, доступные в vcperf.exe, и способы их использования.

Команды для запуска и остановки трассировок

Внимание

Если вы не указали /noadmin, для следующих команд требуются права администратора.

Вариант	Аргументы и описание
/start	[] [] [] [/level3 | | /level2/level1]/nocpusampling/noadmin<sessionName>
	Запускает трассировку под заданным именем сеанса. Параметр /noadmin запускается vcperf.exe без прав администратора и игнорирует /nocpusampling этот параметр. При запуске vcperf без прав администратора на данном компьютере может быть несколько активных сеансов. Параметр /nocpusampling указывает , vcperf.exe не собирает примеры ЦП. Это предотвращает использование представления "Использование ЦП (с выборкой)" в Windows Performance Analyzer, но уменьшает размер собранных трассировок. /level2Параметры /level1или /level3 параметры указывают, какие события MSVC следует собирать, увеличивая уровень информации. Уровень 3 включает все события. Уровень 2 включает все события, кроме событий создания экземпляров шаблона. Уровень 1 включает все события, кроме создания экземпляров шаблона, функций и файлов. Если не указано, /level2 по умолчанию выбран параметр. После запуска трассировки vcperf.exe она возвращается немедленно. Трассировка собирает события на всей системе для всех процессов, выполняемых на компьютере. Это означает, что вам не нужно создавать проект в том же окне командной строки, что и для запуска vcperf.exe. Например, можно создать проект в Visual Studio.
/stop	(1) [/templates] <sessionName> <outputFile.etl> (2) [/templates] <sessionName> /timetrace <outputFile.json>
	Отвечает за остановку трассировки, определенную указанным именем сеанса. Выполняет шаг после обработки трассировки, чтобы создать файл, указанный параметром <outputFile> . Этот /templates параметр включает события создания экземпляров шаблонов в файле. (1) Создает файл, доступный для просмотра в Windows Анализатор производительности (WPA). Выходной .etl файл требует расширения. (2) Создает файл, доступный для просмотра в средстве просмотра трассировки Microsoft Edge (edge://tracing). Выходной .json файл требует расширения.
/stopnoanalyze	<sessionName> <rawOutputFile.etl>
	Остановите трассировку, определенную заданным именем сеанса, при которой необработанные данные записываются в указанный выходной файл. Полученный файл не предназначен для просмотра в WPA. Процесс постобработки, выполняемый командой /stop, иногда занимает достаточно много времени. Вы можете воспользоваться командой /stopnoanalyze, чтобы отложить этот шаг. /analyze Используйте команду, когда вы будете готовы к просмотру файла в Windows Анализатор производительности или средстве просмотра трассировки Microsoft Edge.

Разные команды

Вариант	Аргументы и описание
/analyze	(1) [/templates] <rawInputFile.etl> <outputFile.etl> (2) [/templates] <rawInputFile.etl> /timetrace <outputFile.json>
	Принимает необработанный файл трассировки, созданный с помощью команды /stopnoanalyze. Выполняет шаг после обработки для этой трассировки, чтобы создать файл, указанный параметром <outputFile> . Этот /templates параметр включает события создания экземпляров шаблонов в файле. (1) Создает файл, доступный для просмотра в Windows Анализатор производительности (WPA). Выходной .etl файл требует расширения. (2) Создает файл, доступный для просмотра в средстве просмотра трассировки Microsoft Edge (edge://tracing). Выходной .json файл требует расширения.

См. также

Начало работы с аналитикой сборки C++
Руководство по основам Анализатор производительности Windows
Справочник. Представления Windows Анализатор производительности
Windows Performance Analyzer