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|그룹 |
커널 로깅 세션의 경우 사용하도록 지정할 커널 플래그 및 그룹의 시퀀스를 더하기 기호(+)로 구분합니다. 사용자 로깅 세션의 경우 사용하도록 지정할 공급자 시퀀스를 더하기 기호(+)로 구분합니다. 허용되는 공급자 형식은 |
-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 |
|
-pids pid [...] |
여러 pid를 지정할 때 |
-pidnewprocess <명령줄> |
Xperf가 명령줄>로 시작하는 새 프로세스에 플래그를 <적용합니다. 프라이빗 로거와 함께 사용됩니다. |
-waitfornewprocess |
종료하기 전에 |
-heap |
Pids 및 PidNewProcess에서 지정한 프로세스에서 힙 추적을 사용하도록 설정합니다. |
-critsec |
Pids 및 PidNewProcess에서 지정한 프로세스에서 임계 영역 추적을 사용하도록 설정합니다. |
-setprofint [<n>] [cached] |
샘플링된 프로필 간격을 |
-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> |
스핀 잠금 스핀 임계값을 |
-pooltag< P1>+<P2>+<P3>+<P4> |
더하기 기호(+) 또는 세미콜론(;)으로 구분된 풀 태그 필터(Pn)를 설정합니다. 단일 문자 와일드카드에 물음표(?)를 사용하거나 여러 문자 와일드카드에 별표(*)를 사용합니다. 최대 4개의 필터를 지정할 수 있습니다. |
설명
여러 로거를 여러 시작 옵션을 사용하여 시작할 수 있으며 각 로거에 적용할 옵션이 뒤따를 수 있습니다. LoggerName 또는 -start LoggerName
을 생략하면 커널 로거가 암시됩니다. 커널 로거의 단일 인스턴스만 언제든지 존재할 수 있습니다. 로거 중 하나가 시작되지 않으면 이미 시작된 모든 로거가 중지됩니다.