TraceView 컨트롤 명령
참고
TraceView 명령줄 옵션은 더 이상 사용되지 않습니다. tracepdb.exe 및 tracefmt.exe 사용하여 PDB를 TMF 파일로 구문 분석하고 .etl 파일을 각각 텍스트로 구문 분석합니다.
Traceview 컨트롤 명령을 사용하여 세션 시작 및 중지, 공급자 사용 및 사용 안 함, 추적 세션의 속성 업데이트, 추적 버퍼 플러시 등 추적 세션을 관리합니다.
traceview {-start | -stop | -update | -enable | -disable | -flush | -q} SessionName [Parameters]
traceview {-enumguid | -l | -h | -x}
명령 매개 변수
동작
| 작업 | Description |
|---|---|
| -start | 지정된 추적 세션을 시작합니다. |
| -stop | 지정된 추적 세션을 중지합니다. |
| -update | 지정된 추적 세션의 속성을 업데이트합니다. |
| -enable | 지정된 추적 세션에 대한 공급자를 사용하도록 설정합니다. |
| -disable | 지정된 세션에 대한 공급자를 사용하지 않도록 설정합니다. |
| -flush | 지정된 추적 세션의 활성 버퍼를 플러시합니다. 이 강제 플러시는 버퍼가 가득 찼을 때 및 추적 세션이 중지되는 경우 발생하는 자동 플러시 외에 추가됩니다. |
| -q | 지정된 추적 세션의 상태를 쿼리합니다. |
| -enumguid | ETW(event Tracing for Windows)에 등록된 시스템의 공급자를 나열합니다. |
| -l | 컴퓨터에서 실행되는 모든 추적 세션을 나열합니다. |
| -x | 모든 추적 세션을 중지합니다. |
매개 변수
SessionName
-start와 함께 사용할 경우 SessionName은 추적 세션을 나타내기 위해 선택하는 이름입니다. 다른 모든 명령을 사용하여 SessionName 은 추적 세션을 식별합니다.
-f [LogFile]
-start와 함께 사용하면 -f에서 추적 로그 세션을 시작합니다. LogFile은 이벤트 추적 로그(.etl) 파일의 경로(선택 사항) 및 파일 이름을 지정합니다. 기본값은 C:\LogFile.etl입니다.
-update와 함께 사용하는 경우 -f는 지정된 추적 로그에만 모든 새 추적 메시지를 보냅니다. 이 매개 변수를 사용하여 실시간 추적 세션을 추적 로그 세션으로 변환하거나 기존 추적 로그 세션에 대한 새 추적 로그를 시작합니다. 추적 메시지를 실시간 추적 소비자와 추적 로그에 보내려면 -update 명령에서 -rt 및 -f 매개 변수를 모두 사용합니다.
-rt
-start와 함께 사용하면 -rt가 실시간 추적 세션을 시작합니다(추적 로그 세션(-f)가 기본값입니다.) -start 명령에서 -rt 및 -f를 사용하는 경우 추적 메시지는 추적 소비자 및 이벤트 추적 로그 파일로 전송됩니다.
-update와 함께 사용하는 경우 -rt는 추적 로그 세션에 실시간 메시지 배달을 추가합니다. 모든 새 추적 메시지는 추적 로그 외에도 추적 소비자(실시간 추적 세션)에 직접 전송됩니다.
-guid {#GUIDGUIDFile | }
하나 이상의 추적 공급자를 지정합니다. -start와 함께 사용하여 추적 세션에 대해 공급자를 사용하도록 설정합니다. -enable을 사용하여 공급자를 사용하도록 설정하거나 -flag 또는 -level 값을 변경할 수 있습니다. -disable와 함께 사용하여 사용하지 않도록 설정할 공급자를 지정합니다.
GUID 는 하나 이상의 추적 공급자의 컨트롤 GUID 를 포함하는 컨트롤 GUID(앞에 숫자 기호(#)) 또는 경로(선택 사항) 및 텍스트 파일의 파일 이름(예: 컨트롤 GUID(.ctl) 파일)을 지정할 수 있습니다.
-start 명령에서 -guid 매개 변수를 생략하면 TraceView는 NT 커널 로거 추적 세션을 시작합니다.
TraceView는 다음 하위 매개 변수의 값을 지정된 공급자에 전달합니다.
| 매개 변수 | 설명 |
|---|---|
| SessionName | -start와 함께 사용할 경우 SessionName은 추적 세션을 나타내기 위해 선택하는 이름입니다. 다른 모든 명령을 사용하여 SessionName 은 추적 세션을 식별합니다. |
| -f \[LogFile\] | -start와 함께 사용하면 -f에서 추적 로그 세션을 시작합니다. LogFile은 이벤트 추적 로그(.etl) 파일의 경로(선택 사항) 및 파일 이름을 지정합니다. 기본값은 C:\\LogFile.etl입니다. -update와 함께 사용하면 -f는 지정된 [추적 로그](trace-log.md)에만 모든 새 추적 메시지를 보냅니다. 이 매개 변수를 사용하여 실시간 추적 세션을 추적 로그 세션으로 변환하거나 기존 추적 로그 세션에 대한 새 추적 로그를 시작합니다. 추적 메시지를 실시간 추적 소비자와 추적 로그에 보내려면 -update 명령에서 -rt 및 -f 매개 변수를 모두 사용합니다. |
| -rt | -start와 함께 사용하면 -rt가 실시간 추적 세션을 시작합니다(추적 로그 세션(-f)가 기본값입니다.) -start 명령에서 -rt 및 -f를 사용하는 경우 추적 메시지는 추적 소비자 및 이벤트 추적 로그 파일로 전송됩니다. -update와 함께 사용하는 경우 -rt는 추적 로그 세션에 실시간 메시지 배달을 추가합니다. 모든 새 추적 메시지는 [추적 로그](trace-log.md) 외에도 추적 소비자(실시간 추적 세션)에 직접 전송됩니다. |
| -guid {\#GUIDGUIDFile | } | 하나 이상의 추적 공급자를 지정합니다. -start와 함께 사용하여 추적 세션에 대해 공급자를 사용하도록 설정합니다. -enable을 사용하여 공급자를 사용하도록 설정하거나 -flag 또는 -level 값을 변경할 수 있습니다. -disable와 함께 사용하여 사용하지 않도록 설정할 공급자를 지정합니다. GUID 는 하나 이상의 추적 공급자의 컨트롤 GUID를 포함하는 [control GUID](control GUID](control-guid.md)(앞에 숫자 기호(\#)) 또는 경로(선택 사항) 및 텍스트 파일의 파일 이름(예: 컨트롤 GUID(.ctl) 파일)을 지정할 수 있습니다. -start 명령에서 -guid 매개 변수를 생략하면 TraceView는 [NT 커널 로거 추적 세션](nt-kernel-logger-trace-session.md)을 시작합니다. |
TraceView는 다음 하위 매개 변수의 값을 지정된 공급자에 전달합니다.
| -guid의 하위 매개 변수 | 설명 |
|---|---|
-flagFlag |
|
|
-levelLevel |
추적 세션의 공급자에 대한 추적 수준을 지정합니다. 이 수준은 추적 공급자가 생성하는 이벤트를 결정합니다. 수준은 10진수 또는 16진수 형식의 수준 값을 나타냅니다. 기본값은 0입니다. 수준 값의 의미는 각 추적 공급자에 의해 독립적으로 정의됩니다. 일반적으로 추적 수준은 이벤트의 심각도(정보, 경고 또는 오류)를 나타냅니다. -start 명령에서 수준 값은 추적 세션의 모든 추적 공급자에 적용됩니다. 각 추적 공급자에 대해 서로 다른 수준을 설정하려면 각 추적 공급자에 대해 별도의 -enable 명령을 사용합니다. |
| -bBufferSize | 추적 세션에 할당된 각 버퍼의 크기(KB)를 지정합니다. -start에서만 사용합니다.
기본값은 프로세서 수, 실제 메모리 양 및 사용 중인 운영 체제에 따라 결정됩니다. |
| -minNumberOfBuffers | 추적 메시지를 저장하기 위해 처음에 할당된 버퍼 수를 지정합니다. -start에서만 사용합니다.
기본값은 프로세서 수, 실제 메모리 양 및 사용 중인 운영 체제에 따라 결정됩니다. |
| -maxNumberOfBuffers | -start와 함께 사용할 경우 -max는 추적 세션에 할당된 최대 버퍼 수를 지정합니다. 기본값은 프로세서 수, 실제 메모리 양 및 사용 중인 운영 체제에 따라 결정됩니다.
-update와 함께 사용할 경우 -max는 추적 세션에 할당된 최대 버퍼 수를 변경합니다. |
| -ftFlushTime | -start와 함께 사용할 경우 -ft는 추적 메시지 버퍼가 플러시되는 빈도(초)를 지정합니다. -update와 함께 사용할 경우 -ft는 플러시 시간을 지정된 시간으로 변경합니다.
최소 플러시 시간은 1초입니다. 기본값은 0(강제 플러시 없음)입니다. 이 강제 플러시는 추적 메시지 버퍼가 가득 찼을 때마다 추적 세션이 중지되는 경우 자동으로 발생하는 플러시에 추가됩니다. 참고 항목: -flush. |
| -ageAgeLimit | -start와 함께 사용할 경우 -age는 사용하지 않는 추적 버퍼가 해제되기 전에 유지되는 시간(분)을 지정합니다. -update와 함께 사용할 경우 -age는 연령 제한을 지정된 값으로 변경합니다.
사용 기간 제한 은 사용하지 않는 추적 버퍼가 해제되기 전에 유지되는 시간(분)을 지정합니다. 기본값은 15분입니다. 이 매개 변수는 Windows 2000에서만 유효합니다. |
| -paged | 추적 메시지 버퍼에 대해 페이지 가능한 메모리를 사용합니다. 기본적으로 이벤트 추적은 버퍼에 대해 페이징할 수 없는 메모리를 사용합니다. -start에서만 사용합니다.
공급자가 DISPATCH\_LEVEL보다 큰 IRQL에서 추적 메시지를 생성할 수 있는 드라이버인 경우 이 매개 변수를 사용하지 마세요. 이 매개 변수는 Windows 2000에서 지원되지 않습니다. |
| -seqMaxFileSize | 이벤트 추적 로그(.etl) 파일에 대한 순차 로깅(파일 끝에서 이벤트 기록 중지)을 지정합니다. -start에서만 사용합니다.
MaxFileSize 는 파일의 최대 크기를 MB로 지정합니다. MaxFileSize 값이 없으면 이 매개 변수는 무시됩니다. 순차 로깅은 기본값이지만 이 매개 변수를 사용하여 최대 파일 크기를 설정하거나 -prealloc를 사용할 수 있습니다. 이 매개 변수가 없으면 파일 크기 제한이 없습니다. |
| -cirMaxFileSize | 이벤트 추적 로그(.etl) 파일의 순환 로깅(파일 끝에서 가장 오래된 메시지에 새 메시지 기록)을 지정합니다. -start에서만 사용합니다.
MaxFileSize 는 파일의 최대 크기를 MB로 지정합니다. MaxFileSize 값이 없으면 이 매개 변수는 무시됩니다. 기본값은 파일 크기 제한이 없는 순차 로깅입니다. |
| -prealloc | 할당하기 전에 이벤트 추적 로그(.etl) 파일에 대한 공간을 예약합니다. -start에서만 사용합니다.
이 매개 변수에는 MaxFileSize를 사용하는 -seq 또는 -cir이 필요합니다. -newfile에는 유효하지 않습니다. 시스템은 -seq 또는 -cir 매개 변수를 사용하여 지정된 MaxFileSize 값과 같은 크기의 이벤트 추적 로그(.etl) 파일을 만듭니다. 세션을 중지하면 로그 파일이 해당 콘텐츠의 크기로 줄어듭니다. |
| -newfileMaxFileSize | 기존 파일이 MaxFileSize에 도달할 때마다 새 이벤트 추적 로그(.etl) 파일을 만듭니다. -start에서만 사용합니다.
MaxFileSize 는 각 로그 파일의 최대 크기를 MB로 지정합니다. MaxFileSize 값이 없으면 이 매개 변수는 무시됩니다. -newfile을 사용하는 경우 -fLogFile 매개 변수도 사용해야 하며 LogFile 값은 10진수 패턴을 나타내는 %d 문자를 포함하는 이름이어야 합니다(예: trace%d.etl). 그렇지 않으면 ERROR\_INVALID\_NAME 명령이 실패합니다. Windows 새 파일을 만들 때마다 파일 이름에 10진수 값을 증분합니다. 이 매개 변수는 사전 할당(-prealloc 로깅(-cir), NT 커널 로거 세션 또는 프라이빗 추적 세션에는 유효하지 않습니다. Windows 2000에서는 지원되지 않습니다. |
| -append | 추적 메시지를 기존 이벤트 추적 로그(.etl) 파일에 추가합니다. 기본값은 새 파일을 만드는 것입니다. -start에서만 사용합니다.
이 매개 변수는 순차 파일에서만 유효하며 -f 가 사용되고 -rt 가 사용되지 않는 경우에만 유효합니다. Windows 2000에서는 지원되지 않습니다. |
| -kd | 추적 메시지를 연결된 KD 또는 Windbg로 리디렉션합니다. 또한 이 매개 변수는 추적 버퍼 크기를 디버거의 최대 버퍼 크기인 3KB로 설정하고 명령의 모든 -b 매개 변수를 무시합니다. -start에서만 사용합니다. |
주석
매개 변수가 없는 traceview 명령이 TraceView 창을 엽니다.
TraceView -start 명령을 사용하여 전역 로거 추적 세션을 시작할 수 있습니다. 이렇게 하려면 다음 명령 형식을 사용합니다. 다른 명령과 달리 이 명령 형식의 "GlobalLogger"라는 단어는 대/소문자를 구분합니다.
traceview -start GlobalLogger [parameters]