Lacak Awalan Pesan
Tracefmt menambahkan awalan ke setiap pesan jejak yang terdiri dari data yang disimpan dalam file log jejak peristiwa (.etl) dan file format pesan pelacakan (.tmf).
Tracefmt menyertakan elemen data tertentu secara default, tetapi pengguna dapat menambahkan dan menghapus elemen dengan mengubah variabel lingkungan %TRACE_FORMAT_PREFIX%, string yang menentukan definisi pesan yang kompatibel dengan FormatMessage.
Format awalan pesan pelacakan default adalah sebagai berikut:
[%9!d!]%8!04X!.%3!04X!::%4!s! [%1!s!]
yang menghasilkan awalan berikut:
[CPUNumber]ProcessID.ThreadID :: SystemTime [MessageGUIDFriendlyName]
Setiap %n variabel mewakili parameter yang dijelaskan dalam tabel berikut.
| Pengidentifikasi variabel awalan | Jenis variabel | Deskripsi |
|---|---|---|
%1 |
string |
Nama yang mudah diingat dari GUID pesan pelacakan. Secara default, nama yang mudah diingat dari GUID pesan adalah nama direktori tempat penyedia pelacakan dibangun. Untuk mengubah nama guid pesan yang mudah diingat, gunakan parameter -p dengan Tracewpp atau dengan makro RUN_WPP. Untuk informasi selengkapnya, lihat Opsi Run_WPP. |
%2 |
string |
File sumber dan nomor baris. Variabel ini mewakili nama yang mudah diingat dari pesan jejak. Secara default, nama yang mudah diingat dari pesan pelacakan adalah nama file sumber dan nomor baris kode yang menghasilkan pesan pelacakan. |
%3 |
ULONG |
ID Rangkaian. Mengidentifikasi utas yang menghasilkan pesan pelacakan. |
%4 |
string |
Stempel waktu saat pesan pelacakan dibuat. |
%5 |
string |
Waktu kernel. Menampilkan waktu eksekusi yang berlalu untuk instruksi mode kernel, dalam tanda centang CPU, pada saat pesan pelacakan dibuat. |
%6 |
string |
Waktu pengguna. Menampilkan waktu eksekusi yang berlalu untuk instruksi mode pengguna, dalam tanda centang CPU, pada saat pesan pelacakan dibuat. |
%7 |
PANJANG |
Nomor urut. Menampilkan nomor urut lokal atau global dari pesan pelacakan. Nomor urutan lokal, yang hanya unik untuk sesi pelacakan ini, adalah default. |
%8 |
ULONG |
ID Proses. Mengidentifikasi proses yang menghasilkan pesan pelacakan. |
%9 |
ULONG |
Nomor CPU. Mengidentifikasi CPU tempat pesan jejak dibuat. |
%! FUNC! |
string |
Nama fungsi. Menampilkan nama fungsi yang menghasilkan pesan pelacakan. |
%! BENDERA! |
string |
Menampilkan nama bendera pelacakan yang memfungsikan pesan pelacakan. (Karena makro DoTraceMessage membalikkan bendera dan argumen tingkat, pesan yang dihasilkan oleh DoTraceMessage menampilkan nilai tingkat pelacakan di bidang ini.) |
%! TINGKAT! |
string |
Menampilkan nilai tingkat pelacakan yang memungkinkan pesan pelacakan. (Karena makro DoTraceMessage membalikkan bendera dan argumen tingkat, pesan yang dihasilkan oleh DoTraceMessage menampilkan nama bendera pelacakan di bidang ini.) |
%! COMPNAME! |
string |
Nama Komponen. Menampilkan nama komponen penyedia yang menghasilkan pesan pelacakan. Nama komponen hanya muncul jika ditentukan dalam kode pelacakan. |
%! SUBCOMP! |
string |
Nama subkomponen. Menampilkan nama subkomponen penyedia yang menghasilkan pesan jejak. Nama komponen hanya muncul jika ditentukan dalam kode pelacakan. |
Simbol dalam tanda seru adalah karakter konversi yang menentukan pemformatan dan presisi variabel. Misalnya, %8!04X! menentukan ID proses yang dinyatakan sebagai angka heksadesimal empat digit dan tidak ditandatangani. Karakter konversi ini harus disertakan.
Untuk mengubah elemen, urutan, atau pemformatan awalan pesan pelacakan, gunakan variabel lingkungan %TRACE_FORMAT_PREFIX%. Misalnya, lihat Contoh 7: Menyesuaikan Awalan Pesan Pelacakan.
Untuk contoh konten dalam file TMF, lihat Memformat Lacak Pesan dari Sampel tracedrv.
Selain itu, parameter -csv menambahkan awalan terperinci yang tidak dapat dikonfigurasi ke setiap pesan jejak sebelum awalan Tracefmt standar. Untuk deskripsi bidang dalam awalan CSV, gunakan parameter -csvheader .