다음을 통해 공유

VSPerfReport

  • 아티클

VSPerfReport 명령줄 도구는 Visual Studio 프로파일링 도구의 프로파일링 데이터 파일을 사용하여 보고서를 만드는 데 사용됩니다. 기본 보고서 형식은 .csv 파일입니다.

VSPerfReport는 다음 구문을 사용합니다.

VSPerfReport [/U] vspfilename [/options]

filename은 유효한 .vsp 또는 .vsps 파일이어야 합니다.

VSPerfReport 명령줄 도구는 .vsp 파일이나 .vsps 파일을 비교하는 데도 사용됩니다. 차이점("diff") 보고서를 생성하려면 다음 구문을 사용합니다.

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

vspfilename1 and vspfilename2는 유효한 .vsp 또는 .vsps 파일이어야 합니다.

기호 파일

함수 이름 및 줄 번호와 같은 기호 정보를 표시하려면 VSPerfReport에서 프로파일링된 구성 요소의 기호(.PDB) 파일과 Windows 기호 파일에 액세스해야 합니다. 자세한 내용은 방법: 명령줄에서 기호 파일 위치 지정을 참조하십시오.

일반적인 보고서 옵션

다음 표에서는 일반적인 보고서 서식 옵션 및 보고할 데이터를 선택하는 옵션에 대해 설명합니다.

옵션

설명

U

보고서 출력 및 리디렉션된 콘솔 출력은 유니코드로 작성됩니다. 이 옵션을 가장 먼저 지정해야 합니다.

Summary:[types]

한 가지 형식 이상의 보고서를 만듭니다.

  • All - 모든 보고서 형식이 생성됩니다.

  • CallerCallee - 함수 간의 부모/자식 관계입니다.

  • Function - 호출된 함수입니다.

  • CallTree - 호출된 함수의 계층입니다.

  • Counter - 모든 표시 및 Windows 성능 카운터 값입니다.

  • Ip - 프로파일링된 명령입니다.

  • Life - 할당 데이터를 수집한 경우에 사용 가능한 할당된 개체의 수명입니다.

  • Line - 소스 코드 줄 프로파일 데이터입니다.

  • Header - 파일 헤더 정보가 보고서에 포함됩니다.

  • Mark - 모든 표시입니다.

  • Module - 프로파일링된 모듈입니다.

  • Process - 프로파일링된 프로세스입니다.

  • Thread - 프로파일링된 스레드입니다.

  • Type - 할당된 형식입니다.

  • Contention - 리소스 경합입니다.

  • RuleWarnings - 성능 규칙 문제입니다.

  • ETW - 프로파일링 실행 시 수집된 모든 ETW(Windows용 이벤트 추적) 이벤트입니다. .etl 데이터 파일은 원래 위치나 .vsp 또는 .vsps 파일이 포함된 디렉터리에 있어야 합니다.

Xml

보고서를 XML 형식으로 출력합니다.

CallTrace

함수 시작/종료, ETW 이벤트 및 표시의 목록을 만듭니다.

ClearPackedSymbols

프로파일러 데이터 파일에서 이전에 포함된 기호를 제거합니다. PackSymbols를 다시 실행하기 전에 이 명령을 실행합니다.

SymbolPath:path

프로파일러 데이터 파일의 기호가 포함된 기호 서버나 검색 경로를 하나 이상 지정합니다.

DebugSymPath

기호가 검색되는 위치와 찾았는지 여부를 나열합니다. 이 옵션은 기호 확인 문제를 해결하는 데 유용합니다.

PackSymbols

기호(.pdb) 파일이 분석에 필요하지 않도록 기호를 프로파일링 데이터(.vsp) 파일에 저장합니다.

Output:path|filename

생성된 보고서 파일에 사용할 대체 위치를 지정합니다. 기본적으로 보고서는 현재 디렉터리에 만들어집니다.

SummaryFile

분석을 수행한 후 분석된 정보를 .vsps 요약 파일에 저장합니다.

PrintMarks

지정된 보고서 파일에 있는 모든 표시의 이름 및 타임스탬프를 표시합니다.

?

사용 정보를 표시합니다.

NoLogo

보고서를 실행하는 동안 버전 정보를 숨깁니다.

UserRulesDirectory

사용자 정의 성능 규칙이 포함되는 디렉터리를 지정합니다[아직 구현 안 됨].

필터 옵션

다음 표에서는 사용 가능한 데이터를 필터링하는 옵션에 대해 설명합니다.

옵션

설명

JustMyCode[:[caller][,callee]]

사용자 응용 프로그램 함수 호출만 표시하고 시스템 호출을 숨깁니다.

  • 매개 변수 없음 - 모든 시스템 함수를 숨깁니다.

  • caller - 응용 프로그램 함수를 호출하는 한 수준의 시스템 함수를 표시합니다.

  • callee - 사용자 응용 프로그램 함수에서 호출한 한 수준의 시스템 함수를 표시합니다.

StartTime:[value]

값(밀리초) 이후에 수집한 데이터만 표시합니다.

EndTime:[value]

값(밀리초) 이전에 수집된 데이터만 표시합니다.

FilterFile:VSPFFile

Visual Studio 성능 보고서 창에서 생성된 필터 파일의 위치를 지정합니다.

MsFilter:[starttime,duration]

starttime에서 duration 길이(밀리초)까지의 데이터만 표시합니다.

Process:[pid]

지정한 프로세스의 데이터만 표시합니다.

Thread:[threadid]

지정한 스레드의 데이터만 표시합니다.

Thread:[threadid,processid]

지정한 프로세스와 관련된 지정한 스레드의 데이터만 표시합니다.

차이점 보고서 옵션

다음 표에서는 보고서 파일을 비교할 수 있는 옵션에 대해 설명합니다.

옵션

설명

Diff vspfile1 vspfile2

두 보고서 파일(.vsp 또는 .vsps)을 비교합니다. diff 옵션을 사용하면 요약 옵션이 무시됩니다.

Diff:[value]

이 임계값보다 작은 경우 두 값의 차이가 무시됩니다. 또한 이 임계값보다 낮은 값이 있는 새 데이터는 표시되지 않습니다.

DiffTable:[tablename]

여기에 지정된 테이블을 사용하여 파일을 비교합니다. 기본값은 함수 테이블입니다.

DiffColumn:[columnname]

여기에 지정된 열을 사용하여 값을 비교합니다. 기본값은 전용 샘플 백분율 열입니다.

QueryDiffTables

제공한 두 보고서 파일의 올바른 테이블 및 열을 나열합니다.

참고 항목

기타 리소스

프로파일링 도구 보고서 뷰