File Pesan Ringkasan

File pesan ringkasan adalah file teks yang berisi informasi tentang jejak perangkat lunak. Tracefmt membuat file pesan ringkasan (.sum) setelah memproses pesan dalam log jejak atau sesi pelacakan.

File pesan ringkasan menyertakan data berikut dalam ringkasan statistik:

• Jumlah buffer yang diproses

• Jumlah pesan yang diproses dan hilang

• Waktu yang berlalu, dalam mikro detik, dari sesi pelacakan

Setelah ringkasan statistik adalah tabel yang terdiri dari satu baris untuk setiap pesan pelacakan yang ada dalam pelacakan. Setiap kolom tabel menyediakan informasi berikut tentang pesan pelacakan:

EventCount
Jumlah instans pesan pelacakan dalam pelacakan.

EventName
Nama yang mudah diingat dari GUID pesan pelacakan. Secara default, nama yang mudah diingat dari GUID pesan adalah nama direktori tempat penyedia pelacakan dibangun, tetapi Anda dapat menentukan nama ramah alternatif dengan menggunakan parameter -p untuk RUN_WPP atau Tracewpp.exe. Untuk informasi, lihat Opsi Run_WPP. (EventName memiliki nilai yang sama dengan variabel %1 dalam awalan pesan pelacakan.)

EventType
Nama ramah dari pesan pelacakan. Secara default, nama yang mudah diingat dari pesan jejak adalah nama file sumber dan nomor baris kode yang menghasilkan pesan pelacakan. (EventType memiliki nilai yang sama dengan variabel %2 dalam awalan pesan pelacakan.)

GUID
GUID pesan dari pesan pelacakan.

Contoh berikut menunjukkan file pesan ringkasan untuk log jejak testtrace.etl yang dihasilkan oleh Tracedrv, driver sampel yang diinstrumentasikan untuk pelacakan. TraceDrv, driver sampel yang dirancang untuk pelacakan perangkat lunak, tersedia dari repositori sampel driver Windows di GitHub.

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|
+---------------------------------------------------------------------------------+

Ringkasan sebelumnya menunjukkan bahwa Tracedrv menghasilkan pesan header dan dua pesan pelacakan. Satu pesan jejak dihasilkan oleh pernyataan DoTraceMessage pada baris 264 dan yang lainnya dihasilkan oleh pernyataan DoTraceMessage pada baris 258. Dalam log jejak ini, ada 1700 instans pesan pelacakan pertama dan 17 instans pesan pelacakan kedua.

File pesan ringkasan digunakan terutama untuk menelusuri kesalahan pelacakan perangkat lunak, dan formatnya dapat berubah.