VSPerfReportVSPerfReport

VSPerfReport 명령줄 도구는 데이터 파일을 프로파일링하는 Visual StudioVisual Studio 프로파일링 도구를 사용하여 보고서를 만드는 데 사용됩니다.VSPerfReport command line tool is used to create reports using Visual StudioVisual Studio Profiling Tools profiling data files. 기본 보고서 형식은 .csv 파일입니다.The default report format is a .csv file.

VSPerfReport는 다음 구문을 사용합니다.VSPerfReport uses the following syntax:

VSPerfReport [/U] vspfilename [/options]  

filename은 유효한 .vsp 또는 .vsps 파일이어야 합니다.Note that filename must be a valid .vsp or .vsps file.

VSPerfReport 명령줄 도구는 .vsp 또는 .vsps 파일을 비교하는 데도 사용됩니다.The VSPerfReport command line tool is also used to compare .vsp or .vsps files. 차이("diff") 보고서를 생성하려면 다음 구문을 사용합니다.To generate a difference ("diff") report, use the following syntax:

VSPerfReport [/U] /diff vspfilename1 vspfilename2 [/options]  

vspfilename1 and vspfilename2는 유효한 .vsp 또는 .vsps 파일이어야 합니다.vspfilename1 and vspfilename2 must be valid .vsp or .vsps files.

기호 파일Symbol Files

함수 이름 및 줄 번호와 같은 기호 정보를 표시하려면 VSPerfReport가 프로파일링된 구성 요소의 기호(.PDB) 파일과 Windows 기호 파일에 액세스할 수 있어야 합니다.To display symbol information such as function names and line numbers, VSPerfReport requires access to the symbol (.PDB) files of the profiled components and to Windows symbol files. 자세한 내용은 방법: 명령줄에서 기호 파일 위치 지정을 참조하세요.For more information, see How to: Specify Symbol File Locations from the Command Line.

일반 보고서 옵션General Report Options

다음 표에서는 일반 보고서 서식 옵션과 보고할 데이터를 선택하는 옵션에 대해 설명합니다.The following table describes the general report formatting options and the options that select the data to be reported.

옵션Options 설명Description
UU 보고서 출력 및 리디렉션된 콘솔 출력이 유니코드로 기록됩니다.Report output and redirected console output are written as Unicode. 이 옵션을 첫 번째 옵션으로 지정해야 합니다.Must be the first option specified.
Summary:[types]Summary:[types] 하나 이상의 보고서 형식을 만듭니다.Creates one or more types of reports.

- All - 모든 보고서 형식이 생성됩니다.- All - all report types are generated.
- CallerCallee - 함수 간의 부모/자식 관계입니다.- CallerCallee - parent/child relationships between functions.
- Function - 호출된 함수입니다.- Function - functions called.
- CallTree - 호출된 함수의 계층 구조입니다.- CallTree - hierarchy of functions called.
- Counter - 모든 표시와 Windows 성능 카운터 값입니다.- Counter - all marks together with Windows performance counter values.
- Ip - 프로 파일링된 명령입니다.- Ip - instructions profiled.
- Life - 할당된 개체의 수명입니다(할당 데이터가 수집되면 사용 가능함).- Life - lifetime of allocated objects (available when allocation data has been collected.)
- Line - 소스 코드 줄 프로필 데이터입니다.- Line source code line profile data.
- Header - 보고서에 파일 헤더 정보가 포함됩니다.- Header - report contains file header information.
- Mark - 모든 표시입니다.- Mark all marks.
- Module - 프로파일링된 모듈입니다.- Module - modules profiled.
- Process - 프로파일링된 프로세스입니다.- Process - processes profiled.
- Thread - 프로파일링된 스레드입니다.- Thread - threads profiled.
- Type - 할당된 형식입니다.- Type - allocated types.
- Contention - 리소스 경합입니다.- Contention - resource contentions.
- RuleWarnings - 성능 규칙 문제입니다.- RuleWarnings - performance rule issues
- ETW - 프로 파일링 실행 시 수집된 모든 ETW(Windows용 이벤트 추적) 이벤트입니다.- ETW - all Event Tracing for Windows (ETW) events collected in the profiling run. .etl 데이터 파일은 원래 위치에 있거나 .vsp 또는 .vsps 파일을 포함하는 디렉터리에 있어야 합니다.The .etl data file must be in its original location or in the directory containing the .vsp or .vsps file.
XmlXml 보고서를 XML 형식으로 출력합니다.Output report in XML format.
CallTraceCallTrace 함수 시작 및 종료, ETW 이벤트 및 표시 목록을 만듭니다.Creates a list of function entry and exits, ETW events, and marks.
ClearPackedSymbolsClearPackedSymbols 프로파일러 데이터 파일에서 이전에 포함된 기호를 제거합니다.Removes previously embedded symbols from a profiler data file. PackSymbols를 두 번째로 실행하기 전에 이 명령을 실행합니다.Run this command before running PackSymbols a second time.
SymbolPath: pathSymbolPath: path 프로파일러 데이터 파일에 대한 기호를 포함하는 하나 이상의 검색 경로 또는 기호 서버를 지정합니다.Specifies one or more search paths or symbol servers that contain symbols for the profiler data file.
DebugSymPathDebugSymPath 기호가 검색된 위치 및 찾았는지 여부를 나열합니다.Lists the locations that are searched for symbols and whether they are found. 이 옵션은 기호 확인 문제를 해결하는 데 유용합니다.This option is useful to resolve symbol resolution issues.
PackSymbolsPackSymbols 기호(.pdb) 파일이 분석에 필요 없도록 프로파일링 데이터(.vsp) 파일에 기호를 저장합니다.Saves symbols into the profiling data (.vsp) file so that symbol (.pdb) files are not required for analysis.
Output: path|filenameOutput: path|filename 생성된 보고서 파일에 대한 대체 위치를 지정합니다.Specifies an alternate location for the generated report files. 기본적으로 보고서는 현재 디렉터리에 만들어집니다.By default, reports are created in the current directory.
SummaryFileSummaryFile 분석을 수행한 후 분석한 정보를 .vsps 요약 파일에 저장합니다.Analyze and save the analyzed information in a .vsps summary file.
PrintMarksPrintMarks 지정한 vsp 파일에 있는 모든 표시의 이름 및 타임스탬프를 표시합니다.Show the names and timestamps for all marks in the specified report file.
?? 사용법 정보를 표시합니다.Displays usage information.
NoLogoNoLogo 보고서를 실행하고 있을 때 버전 정보를 숨깁니다.Hides version information when the report is running.
UserRulesDirectoryUserRulesDirectory 사용자 정의 성능 규칙을 포함하는 디렉터리를 지정합니다[아직 구현되지 않음은].Specifies directory containing user-defined performance rules [Not yet implemented].

필터 옵션Filter Options

다음 표에서는 사용할 수 있는 데이터를 필터링하기 위한 옵션에 대해 설명합니다.The following table describes the options to filter the available data.

옵션Options 설명Description
JustMyCode[:[caller][,callee]]JustMyCode[:[caller][,callee]] 사용자 응용 프로그램 함수 호출만 표시하고 시스템 호출은 숨깁니다.Only show user application function calls; hide system calls.

- 매개 변수 없음 - 시스템 함수를 모두 숨깁니다.- No parameters - hide all system functions.
- caller - 응용 프로그램 함수를 호출하는 한 수준의 시스템 함수를 표시합니다.- caller - show one level of system functions that call application functions.
- callee - 사용자 응용 프로그램 함수가 호출하는 한 수준의 시스템 함수를 표시합니다.- callee - show one level of system functions that are called by user application functions.
StartTime:[value]StartTime:[value] value 이후에 수집된 데이터만 표시합니다(밀리초).Only show data collected after value (in milliseconds.)
EndTime:[value]EndTime:[value] value 이전에 수집된 데이터만 표시합니다(밀리초).Only show data collected before value (in milliseconds.)
FilterFile: VSPFFileFilterFile: VSPFFile Visual Studio 성능 보고서 창에서 생성된 필터 파일의 위치를 지정합니다.Specifies the location of a filter file that was generated from the Visual Studio Performance Report window.
MsFilter:[starttime,duration]MsFilter:[starttime,duration] starttime부터 duration 길이(밀리초)까지의 데이터만 표시합니다.Only show data from starttime until the length of duration (in milliseconds.)
Process:[pid]Process:[pid] 지정한 프로세스의 데이터만 표시합니다.Only show data from the specified process.
Thread:[threadid]Thread:[threadid] 지정한 스레드의 데이터만 표시합니다.Only show data from the specified thread.
Thread:[threadid,processid]Thread:[threadid,processid] 지정한 프로세스와 관련된 특정 스레드의 데이터만 표시합니다.Only show data from the specified thread associated with the specified process.

차이점 보고서 옵션Difference Report Options

다음 표에서는 보고서 파일을 비교하기 위한 옵션에 대해 설명합니다.The following table describes the options for comparing report files.

옵션Options 설명Description
Diff vspfile1 vspfile2Diff vspfile1 vspfile2 두 개의 보고서 파일(.vsp 또는 .vsps)을 비교합니다.Compare two report files (.vsp or .vsps) files. diff 옵션을 사용하면 Summary 옵션은 무시됩니다.Summary options will be ignored using the diff option.
Diff:[value]Diff:[value] 이 임계값 아래에서는 두 값의 차이가 무시됩니다.Below this threshold value the difference between two values will be disregarded. 또한 이 임계값보다 낮은 값을 갖는 새 데이터는 표시되지 않습니다.Also, new data with values under this threshold will not be shown.
DiffTable:[tablename]DiffTable:[tablename] 이 특정 테이블을 사용하여 파일을 비교합니다.Use this specific table to compare files. 기본값은 함수 테이블입니다.The default is the functions table.
DiffColumn:[columnname]DiffColumn:[columnname] 이 특정 열 비교 값을 사용합니다.Use this specific column compare values. 기본값은 전용 샘플 백분율 열입니다.The default is the exclusive samples percent column.
QueryDiffTablesQueryDiffTables 제공한 두 보고서 파일의 올바른 테이블 및 열을 나열합니다.List the valid tables and columns for the two report files provided.

참고 항목See Also

성능 보고서 뷰Performance Report Views