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 .