Tracefmt 명령

Tracefmt를 사용하려면 명령 프롬프트 창에 명령을 입력합니다. 다음 구문은 Tracefmt 명령의 요소를 표시합니다.

추적 메시지를 읽을 수 있는 형식으로 표시하려면 Tracefmt가 추적 메시지 형식 파일의 형식 지정 지침을 추적 메시지에 적용해야 합니다. 사용하는 구문은 추적 공급자의 TMF 파일이 있는지 여부 또는 Tracefmt에서 TMF 파일을 만들도록 할지 여부에 따라 달라집니다.

TMF 파일이나 TMF 파일 디렉터리의 경로를 제공하려면


    tracefmt [EtlFile | -rt SessionName][-tmf TMFFile | -p TMFPath ] [Options]

   

TMF 파일을 만들려면


    tracefmt [EtlFile | -rt SessionName]-i ImageFiles [-r SymbolPath ] [-p TmfPath ] [Options]

   

명령줄에 구문을 표시하려면


    tracefmt -h | /?

   

매개 변수

EtlFile

추적 메시지가 포함된 이벤트 추적 로그(.etl) 파일을 지정합니다. 경로(옵션)와 파일 이름을 입력합니다. 기본값은 c:\logfile.etl입니다.

-rt SessionName

실시간입니다. 추적 로그의 추적 메시지가 아니라 지정한 실시간 추적 세션의 추적 메시지에 형식을 지정합니다.

SessionName은 추적 세션의 이름입니다. 기본값은 NT 커널 로거입니다.

-tmf TMFFile

추적 메시지에 대한 추적 메시지 형식(.tmf) 파일의 경로(옵션)와 파일 이름을 지정합니다. 기본값은 WDK에 포함된 파일인 Default.tmf입니다.

-i ImageFiles

Tracefmt가 지정한 이미지 파일의 PDB 기호 파일을 찾고 PDB 파일의 형식 지정 지침에서 TMF 파일을 만들도록 지정합니다.

ImageFiles추적 공급자에 대한 하나 이상 이진 파일(.exe, .dll 또는 .sys)의 경로와 파일 이름을 나타냅니다. 세미콜론(;)을 사용하여 이미지 파일 이름을 구분합니다.

-r SymbolPaths

-i에 지정된 이미지 파일의 개인 PDB 기호 파일 위치를 지정합니다.

SymbolPaths는 개인 기호 또는 기호 서버 경로를 저장하는 디렉터리의 하나 이상 경로를 나타냅니다. 세미콜론(;)을 사용하여 경로 이름을 구분합니다. SymbolPaths의 경로 이름에는 여러 문자를 나타내는 별표(*), 단일 문자를 나타내는 물음표(?) 등 와일드카드 문자를 포함할 수 있습니다.

-i를 명령에 포함하지만 -r을 생략하면 Tracepdb가 %_NT_SYMBOL_PATH% 환경 변수로 지정된 경로에서 지정한 이미지의 PDB 파일을 검색합니다. 환경 변수를 설정하지 않으면 Tracepdb가 기본 기호 경로인 srv*\\\\symbols\\symbols에서 검색합니다.

-p TMFPath

TMF 파일을 저장하는 디렉터리의 경로를 지정합니다.

-i 없이 -p를 사용하면 Tracefmt가 -p로 지정된 경로에서 기존 TMF 파일을 검색합니다. -p를 생략하면 Tracefmt가 %TRACE_FORMAT_SEARCH_PATH% 환경 변수 값(설정된 경우)에서 TMF 파일을 찾습니다. 그렇지 않으면 Tracefmt가 Default.tmf 파일의 형식 지정 지침을 적용하려고 합니다.

-p-i와 함께 사용하면 Tracefmt가 만든 TMF 파일을 -p로 지정된 디렉터리에 배치합니다. -p를 생략하면 Tracefmt가 %TRACE_FORMAT_SEARCH_PATH% 환경 변수 값(설정된 경우)으로 지정된 디렉터리에 TMF 파일을 배치합니다. 그렇지 않으면 Tracefmt가 로컬 디렉터리에 파일을 배치합니다.

-h | /?

도움말을 표시합니다.

-o OutputFile

Tracefmt 출력 파일Tracefmt 요약 메시지 파일의 대체 이름을 지정합니다. 기본값은 로컬 디렉터리의 FmfFile.txt(출력 파일) 및 FmtSum.txt.sum(요약 파일)입니다.

OutputFile은 .txt 파일 이름 확장명을 가진 파일 이름과 경로입니다(예: c:\traces\trace.txt).

이 매개 변수를 -displayonly 또는 -summaryonly 옵션과 함께 사용하면 요약 메시지 파일에만 영향을 줍니다.

-csv

Tracefmt 출력 파일의 형식을 쉼표로 구분된 가변 길이(.csv) 파일로 지정합니다. 이 형식은 표준 추적 메시지 접두사뿐 아니라 각 메시지에 구조화된 세부 접두사를 추가합니다.

이 옵션은 명령 프롬프트 창의 추적 메시지 표시와 출력 파일에 적용됩니다(있는 경우).

-csvheader

설명하는 열 제목 행을 CSV 파일에 추가합니다. 이 헤더는 Tracefmt가 CSV 파일에 추가하는 구조화된 접두사를 해석하는 데 유용합니다. 기본적으로 Tracefmt CSV 파일에는 열 제목이 없습니다.

-csvquote

CSV 파일의 모든 따옴표(")를 이중화합니다. 이 기능은 따옴표로 묶인 경우에만 따옴표를 표시하는 응용 프로그램에 사용됩니다.

-display

추적 메시지를 출력 파일에 쓸 뿐 아니라 명령 프롬프트 창에 표시합니다.

-displayonly

추적 메시지를 명령 프롬프트 창에만 표시하고 출력 파일을 만들지 않습니다.

-nosummary

요약 메시지 파일을 만들지 않습니다.

-summaryonly

요약 메시지 파일만 만듭니다. Tracefmt에서 출력 파일을 만들지 않습니다.

-noprefix

추적 메시지 접두사를 생략합니다. 이 옵션은 출력 파일과 Tracefmt 표시의 추적 메시지에 적용됩니다.

-hires

고해상도입니다. 추적 메시지 타임스탬프에 마이크로초 및 나노초 수를 표시합니다. 기본적으로 밀리초만 표시됩니다.

Tracelog -UsePerfCounter 매개 변수가 사용되는 경우 등 시스템 타이머 대신 성능 카운터 시계 값이 추적 메시지 타임스탬프에 사용되는 경우 이 옵션을 사용합니다. Tracelog 명령에 대한 자세한 내용은 Tracelog Command Syntax를 참조하세요.

-seq

추적 메시지 접두사에 로컬 또는 글로벌 시퀀스 번호를 표시합니다. 시퀀스 번호가 메시지에 기록되지 않은 경우 필드가 초기화되지 않거나 0 또는 "f"로 채워집니다.

-ods

형식이 지정된 추적 메시지를 표시하기 위해 디버거로 보냅니다.

-gmt

각 추적 메시지의 타임스탬프를 GMT(그리니치 표준시)로 표시합니다.

이 옵션은 Tracefmt 출력 파일에만 적용됩니다. 이벤트 추적 로그(.etl) 파일의 타임스탬프를 변환하지 않습니다. Tracefmt 명령을 제출할 때 추적 로그의 표준 시간대가 표시됩니다.

-utc

각 추적 메시지의 타임스탬프를 UTC(협정 세계시)로 표시합니다. UTC는 GMT와 거의 동일하지만 자정을 0으로 나타냅니다.

이 옵션은 Tracefmt 출력 파일에만 적용됩니다. 이벤트 추적 로그(.etl) 파일의 타임스탬프를 변환하지 않습니다. Tracefmt 명령을 제출할 때 추적 로그 파일의 표준 시간대가 표시됩니다.

-trace

발생 시 Tracefmt 작업을 표시합니다. 이 정보는 형식 지정이 잘못된 경우나 Tracefmt가 오류 또는 예외를 보고하는 경우에 유용합니다.

추적 표시는 광범위할 수 있습니다. 나중에 검사하기 위해 Tracefmt 출력을 텍스트 파일로 리디렉션하는 것이 좋습니다.

-v

자세한 정보 표시입니다. Tracefmt가 추적 메시지의 각 블록 또는 버퍼를 처리할 때 명령 프롬프트 창에 자세한 정보를 표시합니다. 파일 손상이나 불일치가 의심되는 경우 이 옵션을 사용합니다.

설명

TMF 파일 찾기

-i 매개 변수를 생략하면 Tracefmt가 다음 메서드를 사용하여 TMF 파일을 찾습니다. 메서드는 Tracefmt에서 사용되는 순서대로 나열됩니다.

  • -tmf 매개 변수

  • -p 매개 변수

  • %TRACE_FORMAT_SEARCH_PATH% 환경 변수

  • WDK에 포함된 파일인 Default.tmf

Tracefmt가 TMF 파일을 찾을 수 없거나 TMF 파일에 추적 메시지의 형식 지정 정보가 포함되지 않은 경우 Tracefmt에서 메시지를 표시할 수 없습니다. Tracefmt는 추적 메시지 대신 다음 오류 메시지를 씁니다.


No Format Information found.

예외 발생

Tracefmt가 추적 메시지 매개 변수의 형식을 지정할 수 없는 경우 예외가 발생하고 다음과 같은 메시지가 표시됩니다.


*****FormatMessage Header(Header) of EventTrace, parameter 23 raised an exception*****

유사한 예외가 표시되는 경우 소스 코드에서 메시지 정의를 검토하고 사용자 지정 변수 유형에 특히 주의합니다. 자세한 내용은 DoTraceMessage을 참조하세요.

GUID가 아닌 파일 이름이 포함된 TMF 파일

TMF 파일 이름이 메시지 GUID가 아닌 경우 -tmf 매개 변수를 사용하여 파일을 식별하고 파일의 정규화된 경로를 입력해야 합니다.

NT 커널 로거 추적 메시지 형식 지정

NT 커널 로거 추적 세션 또는 전역 로거 추적 세션의 메시지에 형식을 지정하려면 -tmf 매개 변수를 사용하여 WDK에 포함된 추적 메시지 형식 파일인 system.tmf 파일을 지정합니다.

실시간 추적 세션의 추적 메시지 형식 지정

-rt(실시간) 매개 변수를 사용하면 Tracefmt가 실시간 모드임을 확인하는 메시지를 표시한 다음 지정한 추적 공급자의 추적 메시지를 기다립니다. 추적 세션이 중지될 때까지 명령 프롬프트로 돌아가지 않습니다.

QPC 타임스탬프 형식 지정

Tracefmt는 시스템 성능 카운터 시계(QueryPerformanceCounter) 값에 올바른 형식을 지정하지 않습니다. 이 고해상도 시간을 사용하는 경우 Windows XP 이상 버전의 Windows에 포함된 도구인 Tracerpt를 사용하여 추적 메시지의 형식을 지정합니다. 자세한 내용은 Tracelog Command Syntax에서 -UsePerfCounter 매개 변수의 설명을 참조하세요.

시퀀스가 잘못된 추적 메시지

Windows XP를 실행하는 컴퓨터에서 추적 메시지 파일을 보는 경우 시퀀스가 잘못된 추적 메시지가 표시될 수도 있습니다. 이 문제를 해결하기 위해 추적 세션을 시작하고 Tracefmt를 사용하여 추적을 볼 때 시퀀스 번호 옵션을 사용할 수 있습니다. 그런 다음 Traceview를 사용하여 추적을 보고 시퀀스 번호에 따라 정렬할 수 있습니다. Windows Server 2003 이상 버전의 Windows를 실행하는 컴퓨터에서 추적을 볼 수도 있습니다.

 

 

표시:
© 2014 Microsoft