추적 메시지 접두사
Tracefmt는 이벤트 추적 로그(.etl) 파일 및 추적 메시지 형식(.tmf) 파일에 저장된 데이터로 구성된 각 추적 메시지에 접두사를 추가합니다.
Tracefmt에는 기본적으로 특정 데이터 요소가 포함되지만 사용자는 FormatMessage와 호환되는 메시지 정의를 지정하는 문자열인 %TRACE_FORMAT_PREFIX% 환경 변수를 변경하여 요소를 추가하고 제거할 수 있습니다.
기본 추적 메시지 접두사 형식은 다음과 같습니다.
[%9!d!]%8!04X!.%3!04X!::%4!s! [%1!s!]
다음과 같은 접두사를 생성합니다.
[CPUNumber]ProcessID.ThreadID :: SystemTime [MessageGUIDFriendlyName]
각 %n 변수는 다음 표에 설명된 매개 변수를 나타냅니다.
접두사 변수 식별자 | 변수 유형 | Description |
---|---|---|
%1 |
문자열 |
추적 메시지의 메시지 GUID 이름입니다. 기본적으로 메시지 GUID의 이름은 추적 공급자 가 빌드된 디렉터리의 이름입니다. 메시지 GUID의 이름을 변경하려면 Tracewpp 또는 RUN_WPP 매크로와 함께 -p 매개 변수를 사용합니다. 자세한 내용은 Run_WPP 옵션을 참조하세요. |
%2 |
문자열 |
원본 파일 및 줄 번호입니다. 이 변수는 추적 메시지의 이름을 나타냅니다. 기본적으로 추적 메시지의 식별 이름은 원본 파일의 이름과 추적 메시지를 생성한 코드의 줄 번호입니다. |
%3 |
ULONG |
스레드 ID입니다. 추적 메시지를 생성한 스레드를 식별합니다. |
%4 |
문자열 |
추적 메시지가 생성된 시간의 타임스탬프를 지정합니다. |
%5 |
문자열 |
커널 시간. 추적 메시지가 생성된 시점의 커널 모드 명령에 대한 경과된 실행 시간을 CPU 틱으로 표시합니다. |
%6 |
문자열 |
사용자 시간. 추적 메시지가 생성된 시점의 사용자 모드 명령에 대한 경과된 실행 시간을 CPU 틱으로 표시합니다. |
%7 |
LONG |
시퀀스 번호입니다. 추적 메시지의 로컬 또는 전역 시퀀스 번호를 표시합니다. 이 추적 세션에만 고유한 로컬 시퀀스 번호가 기본값입니다. |
%8 |
ULONG |
프로세스 ID입니다. 추적 메시지를 생성한 프로세스를 식별합니다. |
%9 |
ULONG |
CPU 번호입니다. 추적 메시지가 생성된 CPU를 식별합니다. |
%! Func! |
문자열 |
함수 이름. 추적 메시지를 생성한 함수의 이름을 표시합니다. |
%! 플래그! |
문자열 |
추적 메시지를 사용하도록 설정하는 추적 플래그 의 이름을 표시합니다. DoTraceMessage 매크로는 플래그 및 수준 인수를 반대로 하기 때문에 DoTraceMessage에서 생성된 메시지는 이 필드에 추적 수준 값을 표시합니다. |
%! 수준! |
문자열 |
추적 메시지를 사용하도록 설정하는 추적 수준의 값을 표시합니다. DoTraceMessage 매크로는 플래그 및 수준 인수를 반대로 하기 때문에 DoTraceMessage에서 생성된 메시지는 이 필드에 추적 플래그의 이름을 표시합니다. |
%! COMPNAME! |
문자열 |
구성 요소 이름입니다. 추적 메시지를 생성한 공급자의 구성 요소 이름을 표시합니다. 구성 요소 이름은 추적 코드에 지정된 경우에만 나타납니다. |
%! SUBCOMP! |
문자열 |
하위 구성 요소 이름입니다. 추적 메시지를 생성한 공급자의 하위 구성 요소 이름을 표시합니다. 구성 요소 이름은 추적 코드에 지정된 경우에만 나타납니다. |
느낌표 내의 기호는 변수의 서식 및 전체 자릿수를 지정하는 변환 문자입니다. 예를 들어 %8!04X! 는 4자리 부호 없는 16진수로 표시되는 프로세스 ID를 지정합니다. 이러한 변환 문자를 포함해야 합니다.
추적 메시지 접두사 요소, 순서 또는 서식을 변경하려면 %TRACE_FORMAT_PREFIX% 환경 변수를 사용합니다. 예제는 예제 7: 추적 메시지 접두사 사용자 지정을 참조하세요.
TMF 파일의 콘텐츠 예제는 tracedrv 샘플에서 추적 메시지 서식 지정을 참조하세요.
또한 -csv 매개 변수는 표준 Tracefmt 접두사 앞에 각 추적 메시지에 구성할 수 없는 자세한 접두사를 추가합니다. CSV 접두사에서 필드에 대한 설명을 보려면 -csvheader 매개 변수를 사용합니다.