다음을 통해 공유

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입니다.

-나는 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 은 c:\traces\trace.txt 같은 .txt 파일 이름 확장명을 가진 경로 및 파일 이름입니다.

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

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

이 옵션은 명령 프롬프트 창에 있는 추적 메시지(있는 경우)의 출력 파일 및 표시에 영향을 줍니다.

-csvheader
설명이 포함된 열 머리글 행을 CSV 파일에 추가합니다. 이 헤더는 Tracefmt가 CSV 파일에 추가하는 구조화된 접두사를 해석하는 데 특히 유용합니다. 기본적으로 Tracefmt CSV 파일에는 열 머리글이 없습니다.

-csvquote
CSV 파일의 모든 따옴표(")를 두 배로 묶습니다. 이 기능은 따옴표로 묶인 경우에만 따옴표를 표시하는 애플리케이션용으로 설계되었습니다.

-전시
명령 프롬프트 창에 추적 메시지를 출력 파일에 쓰는 것 외에도 표시합니다.

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

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

-summaryonly
요약 메시지 파일만 만듭니다. Tracefmt는 출력 파일을 만들지 않습니다.

-noprefix
추적 메시지 접두사를 생략합니다. 이 옵션은 출력 파일 및 Tracefmt 디스플레이의 추적 메시지에 영향을 줍니다.

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

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

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

-ods
표시를 위해 서식이 지정된 추적 메시지를 디버거에 보냅니다.

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

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

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

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

-자취
Tracefmt 작업이 발생할 때 표시됩니다. 이 정보는 서식이 올바르지 않거나 Tracefmt에서 오류 또는 예외를 보고할 때 유용합니다.

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

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

코멘트

TMF 파일 찾기

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

  • -tmf 매개 변수입니다.

  • -p 매개 변수입니다.

  • %TRACE_FORMAT_SEARCH_PATH% 환경 변수입니다.

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

Tracefmt에서 TMF 파일을 찾을 수 없거나 TMF 파일에 추적 메시지에 대한 서식 정보가 포함되어 있지 않으면 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에 포함된 도구인 Tracerpt를 사용하여 추적 메시지의 서식을 지정합니다. 자세한 내용은 Tracelog 명령 구문에서 -UsePerfCounter 매개 변수에 대한 설명을 참조하세요.

순서가 벗어난 추적 메시지

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