다음을 통해 공유


start

logger start 옵션을 표시합니다.

xperf [-start [LoggerName] [ProfileFileName!ProfileName|SessionName]|-update [LoggerName]|[ProfileFileName!ProfileName|SessionName]] -flush [LoggerName] -save ProfileFileName!ProfileName|SessionName merged.etl -setprofint [<n>] [cached] -seteresourcesample <n1> <n2> <n3> -setspinlocksample <n1> <n2> <n3> -pooltag <P1>+<P2>+<P3>+<P4> -on (GUID|KnownProviderName)[:Flags[:Level[<:0xnnnnnnnn|’stack|[,]sid[,]tsid’]]]

매개 변수

명령 설명

-start [LoggerName]|[ ProfileFileName! ProfileName|SessionName]]

LoggerName에 대한 로깅 세션을 시작하거나, ProfileFileName 파일에 정의된 ProfileName 프로필에서 로거를 시작하거나, ProfileFileName 파일에 정의된 로거 SessionName을 시작합니다.

-update [LoggerName]|[ ProfileFileName! ProfileName|SessionName]]

LoggerName에 대한 로깅 세션을 업데이트하거나, ProfileFileName 파일에 정의된 ProfileName 프로필에서 로거를 업데이트하거나, ProfileFileName 파일에 정의된 로거 SessionName을 업데이트합니다.

-flush LoggerName

LoggerName에 대한 로깅 세션을 플러시합니다. 이 매개 변수는 버퍼 모드 추적을 저장하는 데 필요합니다(아래 -buffering 매개 변수 참조). 버퍼 모드 추적을 저장하려면 -flush 매개 변수를 실행해야 합니다.

-capturestate LoggerName Flags

Flags에 지정된 공급자에서 커널이 아닌 로깅 세션으로 상태를 캡처합니다. 허용되는 공급자 형식은 -on과 동일합니다. 플래그와 수준을 지정하면 상태를 캡처하는 동안 사용되도록 설정됩니다.

이는 –buffering 옵션으로 시작된 추적에 대해 호출됩니다. 추적을 중지하려면 –stop이 뒤에 와야 합니다.

-on Flags|그룹

커널 로깅 세션의 경우 사용하도록 지정할 커널 플래그 및 그룹의 시퀀스를 더하기 기호(+)로 구분합니다. 사용자 로깅 세션의 경우 사용하도록 지정할 공급자 시퀀스를 더하기 기호(+)로 구분합니다. 허용되는 공급자 형식은 (GUID|KnownProviderName)[:Flags[:Level]]입니다. 유효한 플래그 목록은 공급자를 참조하세요.

-f 파일 이름

지정된 파일에 이벤트를 기록합니다. 기본값은 커널 추적의 경우 \Kernel.etl이고 사용자 추적의 경우 \User.etl입니다.

-buffersize Size

추적 버퍼 크기를 KB 단위의 Size로 설정합니다. 가능한 값은 4~1024입니다. 기본값은 64입니다.

-minbuffers n

최소 추적 버퍼 수를 n으로 설정합니다. 기본값은 64입니다.

-maxbuffers n

최대 추적 버퍼 수를 n으로 설정합니다. 기본값은 320입니다.

-maxfile Size

최대 파일 크기를 SizeMB로 설정합니다.

-flushtimer n

플러시 타이머를 n초로 설정합니다.

-boottrace Flags|그룹|끄기

부팅을 추적하도록 Windows 로거에 대한 이벤트 추적을 구성합니다. 플래그를 “끄기”로 설정하여 부팅 추적을 해제합니다. 모든 로깅 컨트롤은 이와 함께 사용할 수 있습니다. \Perf.etl 이외의 파일에 기록하려면 -f와 함께 사용하세요.

-realtime

실시간 추적을 사용하도록 설정합니다.

-buffering

버퍼링 모드 추적을 사용하도록 설정합니다. 저장하려면 -flush를 사용합니다. -stop 옵션은 추적을 저장하지 않습니다.

-filemode 모드

파일 모드를 설정합니다. 기본값은 “Sequential”입니다. “Sequential”, “Circular”, “Append”, “NewFile” 모드가 가능합니다.

-clocktype ClockType

시계 형식을 설정합니다. 기본값은 “PerfCounter”입니다. “Cycle”, “PerfCounter”, “SystemTime” 형식이 가능합니다.

-stackwalk 플래그|@file

Flag+...로 지정된 이벤트에 대해 스택 워킹을 활성화하거나 플래그에 대한 file 파일을 구문 분석합니다. 자세한 내용은 stackwalk를 참조하세요.

-pids pid [...]

pid [...] 프로세스에 플래그를 적용합니다. 프라이빗 로거와 함께 사용됩니다.

여러 pid를 지정할 때 -Pids 1234 6789에서와 같이 공백으로 구분합니다.

-pidnewprocess <명령줄>

Xperf가 명령줄>로 시작하는 새 프로세스에 플래그를 <적용합니다. 프라이빗 로거와 함께 사용됩니다.

-waitfornewprocess

종료하기 전에 -pidNewProcess를 사용하여 만든 새 프로세스가 반환될 때까지 기다립니다.

-heap

PidsPidNewProcess에서 지정한 프로세스에서 힙 추적을 사용하도록 설정합니다.

-critsec

PidsPidNewProcess에서 지정한 프로세스에서 임계 영역 추적을 사용하도록 설정합니다.

-setprofint [<n>] [cached]

샘플링된 프로필 간격을 <n> [1221..10000000]으로 설정합니다. 캐시됨을 지정하면 샘플링된 프로필이 있는 새 ETW 커널 로거가 시작될 때마다 간격이 ETW에 캐시되고 다시 적용됩니다. 단위는 100ns입니다. n의 기본값은 10000입니다. 즉, 1ms는 캐시되지 않습니다.

-Save ProfileFileName! ProfileName|SessionName merged.etl

ProfileFileName 파일에 정의된 프로필 ProfileName에서 로거를 플러시하고 ETL 파일을 merged.etl에 병합하거나 ProfileFileName 파일에 정의된 로거 SessionName을 플러시하고 ETL 파일을 Merged.etl에 병합합니다.

-seteresourcesample <n1><n2><n3>

ERESOURCE 샘플링을 설정합니다. 여기서 n1 릴리스 샘플링 속도는 1000 이상, n2 경합 샘플링 속도는 1 이상, n3 초과 시간 제한 횟수는 1 이상입니다. 경합 샘플 속도는 충돌이 발생할 때 스핀 잠금 이벤트를 획득하는 속도입니다. 예를 들어 이 값이 100이면 각 100개의 스핀 잠금 충돌에 대해 하나의 스핀 잠금 이벤트가 획득됩니다.

-setspinlocksample <n1><n2><n3>

스핀 잠금 스핀 임계값을 <n1> [ >=1]로 설정합니다. 스핀 잠금 획득 샘플 속도를 <n2> [ >= 1000]로 설정합니다. 스핀 잠금 경합 샘플 속도를 <n3> [ >= 1]으로 설정합니다. 64비트 Windows 7, Windows Server 2008 R2 및 최신 버전의 운영 체제만 스핀 잠금 계측을 지원합니다.

-pooltag< P1>+<P2>+<P3>+<P4>

더하기 기호(+) 또는 세미콜론(;)으로 구분된 풀 태그 필터(Pn)를 설정합니다. 단일 문자 와일드카드에 물음표(?)를 사용하거나 여러 문자 와일드카드에 별표(*)를 사용합니다. 최대 4개의 필터를 지정할 수 있습니다.

설명

여러 로거를 여러 시작 옵션을 사용하여 시작할 수 있으며 각 로거에 적용할 옵션이 뒤따를 수 있습니다. LoggerName 또는 -start LoggerName을 생략하면 커널 로거가 암시됩니다. 커널 로거의 단일 인스턴스만 언제든지 존재할 수 있습니다. 로거 중 하나가 시작되지 않으면 이미 시작된 모든 로거가 중지됩니다.

Xperf 옵션