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}

명령 매개 변수

actions

작업 설명
-시작하다 지정된 추적 세션을 시작합니다.
-멈추다 지정된 추적 세션을 중지합니다.
-업데이트 지정된 추적 세션의 속성을 업데이트합니다.
-사용 지정된 추적 세션에 대해 공급자를 사용하도록 설정합니다.
-비활성화 지정된 세션에 대해 공급자를 사용하지 않도록 설정합니다.
-플러시 지정된 추적 세션의 활성 버퍼를 플러시합니다. 이 강제 플러시는 버퍼가 가득 찼을 때 및 추적 세션이 중지되는 경우 발생하는 자동 플러시 외에 추가됩니다.
-q 지정된 추적 세션의 상태를 쿼리합니다.
-enumguid ETW(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 {#GUID | GUIDFile}
하나 이상의 추적 공급자를 지정합니다. -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 {\#GUID | GUIDFile}

하나 이상의 추적 공급자를 지정합니다. -start와 함께 사용하여 추적 세션에 공급자를 사용하도록 설정합니다. -enable과 함께 사용하여 공급자를 사용하도록 설정하거나 -flag 또는 -level 값을 변경합니다. -disable과 함께 사용하여 사용하지 않도록 설정할 공급자를 지정합니다.

GUID 는 하나 이상의 추적 공급자의 컨트롤 GUID를 포함하는 [컨트롤 GUID](control-guid.md)\# 또는 경로(선택 사항) 및 텍스트 파일의 파일 이름(예: 컨트롤 GUID(.ctl) 파일)을 지정할 수 있습니다.

-start 명령에서 -guid 매개 변수를 생략하면 TraceView는 [NT 커널 로거 추적 세션](nt-kernel-logger-trace-session.md)을 시작합니다.

TraceView는 다음 하위 매개 변수의 값을 지정된 공급자에 전달합니다.

-b BufferSize
추적 세션에 할당된 각 버퍼의 크기(KB)를 지정합니다. -start에서만 사용합니다.

기본값은 프로세서 수, 실제 메모리 양 및 사용 중인 운영 체제에 따라 결정됩니다.

-분 NumberOfBuffers
추적 메시지를 저장하기 위해 처음에 할당된 버퍼 수를 지정합니다. -start에서만 사용합니다.

기본값은 프로세서 수, 실제 메모리 양 및 사용 중인 운영 체제에 따라 결정됩니다.

-최대 NumberOfBuffers
-start와 함께 사용할 경우 -max는 추적 세션에 할당된 최대 버퍼 수를 지정합니다. 기본값은 프로세서 수, 실제 메모리 양 및 사용 중인 운영 체제에 따라 결정됩니다.

-update와 함께 사용할 경우 -max는 추적 세션에 할당된 최대 버퍼 수를 변경합니다.

-피트 FlushTime
-start와 함께 사용할 경우 -ft는 추적 메시지 버퍼가 플러시되는 빈도(초)를 지정합니다. -update와 함께 사용할 경우 -ft는 플러시 시간을 지정된 시간으로 변경합니다.

최소 플러시 시간은 1초입니다. 기본값은 0(강제 플러시 없음)입니다.

이 강제 플러시는 추적 메시지 버퍼가 가득 찼을 때마다 추적 세션이 중지되는 경우 자동으로 발생하는 플러시 외에 추가됩니다.

참고 항목: -flush.

-페이징
추적 메시지 버퍼에 대해 페이지 가능한 메모리를 사용합니다. 기본적으로 이벤트 추적은 버퍼에 대해 페이징할 수 없는 메모리를 사용합니다. -start에서만 사용합니다.

공급자가 DISPATCH_LEVEL보다 큰 IRQL에서 추적 메시지를 생성할 수 있는 드라이버인 경우 이 매개 변수를 사용하지 마세요.

이 매개 변수는 Windows 2000에서 지원되지 않습니다.

-seq MaxFileSize
이벤트 추적 로그(.etl) 파일에 대한 순차적 로깅(파일 끝에서 이벤트 기록 중지)을 지정합니다. -start에서만 사용합니다.

MaxFileSize 는 파일의 최대 크기를 MB로 지정합니다. MaxFileSize 값이 없으면 이 매개 변수는 무시됩니다.

순차 로깅은 기본값이지만 이 매개 변수를 사용하여 최대 파일 크기를 설정하거나 -prealloc를 사용할 수 있습니다. 이 매개 변수가 없으면 파일 크기 제한이 없습니다.

-cir MaxFileSize
이벤트 추적 로그(.etl) 파일에서 순환 로깅(파일 끝에서 가장 오래된 메시지에 새 메시지 기록)을 지정합니다. -start에서만 사용합니다.

MaxFileSize 는 파일의 최대 크기를 MB로 지정합니다. MaxFileSize 값이 없으면 이 매개 변수는 무시됩니다.

기본값은 파일 크기 제한이 없는 순차 로깅입니다.

-prealloc
할당하기 전에 이벤트 추적 로그(.etl) 파일에 대한 공간을 예약합니다. -start에서만 사용합니다.

이 매개 변수에는 MaxFileSize를 사용하는 -seq 또는 -cir이 필요합니다. -newfile에는 유효하지 않습니다.

플래그 는 추적 공급자에 정의된 플래그 값을 10진수 또는 16진수 형식으로 나타냅니다. 기본값은 0입니다. 0x01000000 0xFF000000 값은 나중에 사용하도록 예약됩니다.

플래그의 의미는 각 추적 공급자에 의해 독립적으로 정의됩니다. 일반적으로 플래그는 점점 더 자세한 보고 수준을 나타냅니다.

-start 명령에서 플래그 값은 추적 세션의 모든 추적 공급자에 적용됩니다. 각 추적 공급자에 대해 서로 다른 플래그를 설정하려면 각 추적 공급자에 대해 별도의 -enable 명령을 사용합니다.

-guid의 하위 매개 변수 설명

-flag 플래그

-level Level

추적 세션의 공급자에 대한 추적 수준을 지정합니다. 수준은 추적 공급자가 생성하는 이벤트를 결정합니다.

수준은 10진수 또는 16진수 형식의 수준 값을 나타냅니다. 기본값은 0입니다.

수준 값의 의미는 각 추적 공급자에 의해 독립적으로 정의됩니다. 일반적으로 추적 수준은 이벤트의 심각도(정보, 경고 또는 오류)를 나타냅니다.

-start 명령에서 수준 값은 추적 세션의 모든 추적 공급자에 적용됩니다. 각 추적 공급자에 대해 서로 다른 수준을 설정하려면 각 추적 공급자에 대해 별도의 -enable 명령을 사용합니다.
매개 변수설명
-b BufferSize 추적 세션에 할당된 각 버퍼의 크기(KB)를 지정합니다. -start에서만 사용합니다.

기본값은 프로세서 수, 실제 메모리 양 및 사용 중인 운영 체제에 따라 결정됩니다.
-min NumberOfBuffers 추적 메시지를 저장하기 위해 처음에 할당된 버퍼 수를 지정합니다. -start에서만 사용합니다.

기본값은 프로세서 수, 실제 메모리 양 및 사용 중인 운영 체제에 따라 결정됩니다.
-max NumberOfBuffers -start와 함께 사용할 경우 -max는 추적 세션에 할당된 최대 버퍼 수를 지정합니다. 기본값은 프로세서 수, 실제 메모리 양 및 사용 중인 운영 체제에 따라 결정됩니다.

-update와 함께 사용할 경우 -max는 추적 세션에 할당된 최대 버퍼 수를 변경합니다.
-ft FlushTime -start와 함께 사용할 경우 -ft는 추적 메시지 버퍼가 플러시되는 빈도(초)를 지정합니다. -update와 함께 사용할 경우 -ft는 플러시 시간을 지정된 시간으로 변경합니다.

최소 플러시 시간은 1초입니다. 기본값은 0(강제 플러시 없음)입니다.

이 강제 플러시는 추적 메시지 버퍼가 가득 찼을 때마다 추적 세션이 중지되는 경우 자동으로 발생하는 플러시 외에 추가됩니다.

참고 항목: -flush.
-age AgeLimit -start와 함께 사용할 경우 -age는 사용하지 않은 추적 버퍼가 해제되기 전에 유지되는 기간(분)을 지정합니다. -update와 함께 사용하는 경우 -age는 연령 제한을 지정된 값으로 변경합니다.

기간 제한 은 사용하지 않은 추적 버퍼가 해제되기 전에 유지되는 기간(분)을 지정합니다. 기본값은 15분입니다.

이 매개 변수는 Windows 2000에서만 유효합니다.
-페이징 추적 메시지 버퍼에 대해 페이지 가능한 메모리를 사용합니다. 기본적으로 이벤트 추적은 버퍼에 대해 페이징할 수 없는 메모리를 사용합니다. -start에서만 사용합니다.

공급자가 DISPATCH\_LEVEL보다 큰 IRQL에서 추적 메시지를 생성할 수 있는 드라이버인 경우 이 매개 변수를 사용하지 마세요.

이 매개 변수는 Windows 2000에서 지원되지 않습니다.
-seq MaxFileSize 이벤트 추적 로그(.etl) 파일에 대한 순차적 로깅(파일 끝에서 이벤트 기록 중지)을 지정합니다. -start에서만 사용합니다.

MaxFileSize 는 파일의 최대 크기를 MB로 지정합니다. MaxFileSize 값이 없으면 이 매개 변수는 무시됩니다.

순차 로깅은 기본값이지만 이 매개 변수를 사용하여 최대 파일 크기를 설정하거나 -prealloc를 사용할 수 있습니다. 이 매개 변수가 없으면 파일 크기 제한이 없습니다.
-cir MaxFileSize 이벤트 추적 로그(.etl) 파일에서 순환 로깅(파일 끝에서 가장 오래된 메시지에 새 메시지 기록)을 지정합니다. -start에서만 사용합니다.

MaxFileSize 는 파일의 최대 크기를 MB로 지정합니다. MaxFileSize 값이 없으면 이 매개 변수는 무시됩니다.

기본값은 파일 크기 제한이 없는 순차 로깅입니다.
-prealloc 할당하기 전에 이벤트 추적 로그(.etl) 파일에 대한 공간을 예약합니다. -start에서만 사용합니다.

이 매개 변수에는 MaxFileSize를 사용하는 -seq 또는 -cir이 필요합니다. -newfile에는 유효하지 않습니다.

시스템은 -seq 또는 -cir 매개 변수를 사용하여 지정된 MaxFileSize 값과 같은 크기의 이벤트 추적 로그(.etl) 파일을 만듭니다. 세션을 중지하면 로그 파일이 해당 콘텐츠의 크기로 줄어듭니다.
-newfile MaxFileSize 기존 파일이 MaxFileSize에 도달할 때마다 새 이벤트 추적 로그(.etl) 파일을 만듭니다. -start에서만 사용합니다.

MaxFileSize 는 각 로그 파일의 최대 크기를 MB로 지정합니다. MaxFileSize 값이 없으면 이 매개 변수는 무시됩니다.

-newfile을 사용하는 경우 -f LogFile 매개 변수도 사용해야 하며 LogFile 값은 소수점 패턴을 나타내는 문자 %d(예: trace%d.etl)를 포함하는 이름이어야 합니다. 그렇지 않으면 ERROR\_INVALID\_NAME 명령이 실패합니다. Windows는 새 파일을 만들 때마다 파일 이름에 10진수 값을 증분합니다.

이 매개 변수는 사전 할당(-prealloc 로깅(-cir), NT 커널 로거 세션 또는 프라이빗 추적 세션에서는 유효하지 않습니다. Windows 2000에서는 지원되지 않습니다.
-덧붙이다 추적 메시지를 기존 이벤트 추적 로그(.etl) 파일에 추가합니다. 기본값은 새 파일을 만드는 것입니다. -start에서만 사용합니다.

이 매개 변수는 순차 파일에서만 유효하며 -f가 사용되고 -rt가 사용되지 않는 경우에만 유효합니다. Windows 2000에서는 지원되지 않습니다.
-kd 추적 메시지를 연결된 KD 또는 Windbg로 리디렉션합니다. 또한 이 매개 변수는 추적 버퍼 크기를 디버거의 최대 버퍼 크기인 3KB로 설정하고 명령의 모든 -b 매개 변수를 무시합니다. -start에서만 사용합니다.

설명

매개 변수가 없는 traceview 명령이 TraceView 창을 엽니다.

TraceView -start 명령을 사용하여 전역 로거 추적 세션을 시작할 수 있습니다. 이렇게 하려면 다음 명령 형식을 사용합니다. 다른 명령과 달리 이 명령 형식의 "GlobalLogger"라는 단어는 대/소문자를 구분합니다.

traceview -start GlobalLogger [parameters]