참조: vcperf 명령

이 문서에서는 사용 가능한 명령과 사용 vcperf.exe방법을 나열하고 설명합니다.

추적을 시작 및 중지하는 명령

Important

지정 /noadmin하지 않는 한 다음 명령에는 관리 권한이 필요합니다.

옵션	인수 및 설명
/start	[/noadmin] [/nocpusampling] [/level1 | /level2 | /level3] <sessionName>
	지정된 세션 이름 아래에서 추적을 시작합니다. 이 /noadmin 옵션은 관리자 권한 없이 vcperf.exe 실행되며 이 옵션은 무시됩니다/nocpusampling. 관리자 권한 없이 vcperf를 실행하는 경우 지정된 머신에 둘 이상의 활성 세션이 있을 수 있습니다. 이 /nocpusampling 옵션은 CPU 샘플을 수집하지 않는 vcperf.exe 지정합니다. Windows 성능 분석기에서 CPU 사용량(샘플링) 보기를 사용하지 못하도록 하지만 수집된 추적을 더 작게 만듭니다. /level1, /level2또는 /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) WPA(Windows 성능 분석기)에서 볼 수 있는 파일을 생성합니다. 출력 파일에는 확장 프로그램이 .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) WPA(Windows 성능 분석기)에서 볼 수 있는 파일을 생성합니다. 출력 파일에는 확장 프로그램이 .etl 필요합니다. (2) Microsoft Edge 추적 뷰어(edge://tracing)에서 볼 수 있는 파일을 생성합니다. 출력 파일에는 확장 프로그램이 .json 필요합니다.

참고 항목

C++ Build Insights 활용 시작
자습서: Windows 성능 분석기 기본 사항
참조: Windows 성능 분석기 보기
Windows Performance Analyzer