다음을 통해 공유


요약 메시지 파일

요약 메시지 파일은 소프트웨어 추적에 대한 정보를 포함하는 텍스트 파일입니다. Tracefmt는 추적 로그 또는 추적 세션에서 메시지를 처리한 후 요약 메시지(.sum) 파일을 만듭니다.

요약 메시지 파일에는 통계 요약에 다음 데이터가 포함됩니다.

  • 처리된 버퍼 수

  • 처리 및 손실된 메시지 수

  • 추적 세션의 경과 시간(마이크로초)입니다.

통계 요약 다음에는 추적에 표시되는 각 추적 메시지에 대해 하나의 행으로 구성된 테이블이 있습니다. 테이블의 각 열은 추적 메시지에 대한 다음 정보를 제공합니다.

EventCount
추적에 있는 추적 메시지의 인스턴스 수입니다.

Eventname
추적 메시지의 메시지 GUID 이름입니다. 기본적으로 메시지 GUID의 식별 이름은 추적 공급자가 빌드된 디렉터리의 이름이지만 -p 매개 변수를 사용하여 RUN_WPP 또는 Tracewpp.exe 대체 이름을 지정할 수 있습니다. 자세한 내용은 Run_WPP 옵션을 참조하세요. EventName의 값은 추적 메시지 접두사에 있는 %1 변수와 같습니다.

EventType
추적 메시지의 이름입니다. 기본적으로 추적 메시지의 식별 이름은 원본 파일의 이름과 추적 메시지를 생성한 코드의 줄 번호입니다. EventType의 값은 추적 메시지 접두사에 있는 %2 변수와 같습니다.

Guid
추적 메시지의 메시지 GUID입니다.

다음 예제에서는 추적을 위해 계측된 샘플 드라이버인 Tracedrv에서 생성된 testtrace.etl 추적 로그에 대한 요약 메시지 파일을 보여 둡니다. 소프트웨어 추적용으로 설계된 샘플 드라이버인 TraceDrv는 GitHub의 Windows 드라이버 샘플 리포지토리에서 사용할 수 있습니다.

Files Processed:
d:\DDK Tools\tracetools\testtrace.etl
Total Buffers Processed 4
Total Events  Processed 1718
Total Events  Lost      4
Elapsed Time            122 sec
+---------------------------------------------------------------------------------+
|EventCount    EventName    EventType         Guid                                |
+---------------------------------------------------------------------------------+
|         1    Header       Header            68fdd900-4a3e-11d1-84f4-0000f80464e3|
|      1700    tracedrv     tracedrv_c264     37753236-c81f-505e-d40a-128d3bb2b5ff|
|        17    tracedrv     tracedrv_c258     37753236-c81f-505e-d40a-128d3bb2b5ff|
+---------------------------------------------------------------------------------+

위의 요약은 Tracedrv가 헤더 메시지와 두 개의 추적 메시지를 생성한다는 것을 보여줍니다. 한 추적 메시지는 줄 264의 DoTraceMessage 문에 의해 생성되고 다른 하나는 258줄의 DoTraceMessage 문에 의해 생성됩니다. 이 추적 로그에는 첫 번째 추적 메시지의 1700개 인스턴스와 두 번째 추적 메시지의 17개 인스턴스가 있습니다.

요약 메시지 파일은 주로 소프트웨어 추적을 디버그하는 데 사용되며 해당 형식은 변경될 수 있습니다.