Bagikan melalui

Perintah Tracefmt

  • Artikel

Untuk menggunakan Tracefmt, ketik perintah di jendela Prompt Perintah. Sintaks berikut menampilkan elemen perintah Tracefmt.

Untuk menampilkan pesan pelacakan dalam bentuk yang dapat dibaca, Tracefmt harus menerapkan instruksi pemformatan dalam file format pesan pelacakan ke pesan pelacakan. Sintaks yang Anda gunakan bergantung pada apakah Anda memiliki file TMF untuk penyedia pelacakan, atau apakah Anda ingin Tracefmt membuat file TMF.

Untuk menyediakan file TMF atau jalur ke direktori file TMF:

    tracefmt [EtlFile | -rt SessionName][-tmf TMFFile | -p TMFPath ] [Options]

Untuk membuat file TMF:

    tracefmt [EtlFile | -rt SessionName]-i ImageFiles [-r SymbolPath ] [-p TmfPath ] [Options]

Untuk menampilkan sintaks pada baris perintah.

    tracefmt -h | /?

Parameter

EtlFile
Menentukan file log jejak peristiwa (.etl) yang berisi pesan pelacakan. Masukkan jalur (opsional) dan nama file. Defaultnya adalah c:\logfile.etl.

-Rt SessionName
Real time. Memformat pesan pelacakan dari sesi pelacakan real-time yang ditentukan, bukan dari log jejak.

SessionName adalah nama sesi pelacakan. Defaultnya adalah NT Kernel Logger.

-tmf TMFFile
Menentukan jalur (opsional) dan nama file file format pesan pelacakan (.tmf) untuk pesan pelacakan. Nilai defaultnya adalah Default.tmf, file yang disertakan dalam WDK.

-saya ImageFiles
Mengarahkan Tracefmt untuk menemukan file simbol PDB untuk file gambar yang ditentukan dan untuk membuat file TMF dari instruksi pemformatan dalam file PDB.

ImageFiles mewakili jalur dan nama file dari satu atau beberapa file biner (.exe, .dll, atau .sys) untuk penyedia pelacakan. Gunakan titik koma (;) untuk memisahkan nama file gambar.

-r SymbolPaths
Menentukan lokasi file simbol PDB privat untuk file gambar yang ditentukan dalam -i.

SymbolPaths mewakili satu atau beberapa jalur ke direktori yang menyimpan simbol privat atau jalur server simbol. Gunakan titik koma (;) untuk memisahkan nama jalur. Nama jalur dalam SymbolPaths dapat menyertakan karakter kartubebas , seperti tanda bintang (*) untuk mewakili beberapa karakter dan tanda tanya (?) untuk mewakili satu karakter.

Jika Anda menyertakan -i dalam perintah, tetapi hilangkan -r, Tracepdb mencari file PDB untuk gambar yang ditentukan dalam jalur yang ditentukan oleh variabel lingkungan %_NT_SYMBOL_PATH%. Jika variabel lingkungan tidak diatur, Tracepdb mencari di jalur simbol default, srv*\\\\symbols\\symbols.

-p TMFPath
Menentukan jalur ke direktori yang menyimpan file TMF.

Ketika -p digunakan tanpa -i, Tracefmt mencari di jalur yang ditentukan oleh -p untuk file TMF yang ada. Jika -p dihilangkan Tracefmt mencari file TMF dalam nilai variabel lingkungan %TRACE_FORMAT_SEARCH_PATH%, jika diatur. Jika tidak, Tracefmt mencoba menerapkan instruksi pemformatan dalam file Default.tmf.

Ketika -p digunakan dengan -i, Tracefmt menempatkan file TMF yang dibuatnya di direktori yang ditentukan oleh -p. Jika -p dihilangkan, Tracefmt menempatkan file TMF dalam direktori yang ditentukan oleh nilai variabel lingkungan %TRACE_FORMAT_SEARCH_PATH%, jika diatur. Jika tidak, Tracefmt menempatkan file di direktori lokal.

-h | /?
Menampilkan bantuan.

-o OutputFile
Menentukan nama alternatif untuk file output Tracefmt dan file pesan ringkasan Tracefmt. Nilai default adalah FmfFile.txt (untuk file output) dan FmtSum.txt.sum (untuk file ringkasan) di direktori lokal.

OutputFile adalah jalur dan nama file dengan ekstensi nama file .txt, seperti c:\traces\trace.txt.

Jika Anda menggunakan parameter ini dengan opsi -displayonly atau -summaryonly , parameter ini hanya memengaruhi file pesan ringkasan.

-csv
Memformat file output Tracefmt sebagai file panjang variabel (.csv) yang dipisahkan koma. Format ini menambahkan awalan terstruktur terperinci ke setiap pesan, selain awalan pesan pelacakan standar.

Opsi ini memengaruhi file output dan tampilan pesan pelacakan di jendela Prompt Perintah, jika ada.

-csvheader
Menambahkan baris judul kolom deskriptif ke file CSV. Header ini sangat berguna untuk menafsirkan awalan terstruktur yang ditambahkan Tracefmt ke file CSV. Secara default, file CSV Tracefmt tidak memiliki judul kolom.

-csvquote
Menggandakan semua tanda kutip (") dalam file CSV. Fitur ini dirancang untuk aplikasi yang menampilkan tanda kutip hanya ketika diapit tanda kutip.

-menampilkan
Menampilkan pesan pelacakan di jendela Prompt Perintah, selain menulisnya ke file output.

-displayonly
Menampilkan pesan pelacakan hanya di jendela Prompt Perintah, dan tidak membuat file output.

-nosummary
Tidak membuat file pesan ringkasan.

-summaryonly
Hanya membuat file pesan ringkasan. Tracefmt tidak membuat file output.

-noprefix
Menghilangkan awalan pesan pelacakan. Opsi ini memengaruhi pesan pelacakan dalam file output dan tampilan Tracefmt.

-Menyewa
Resolusi tinggi. Menampilkan jumlah mikrodetik dan nanodetik dalam stempel waktu pesan pelacakan. Secara default, hanya milidetik yang ditampilkan.

Gunakan opsi ini saat nilai jam penghitung kinerja digunakan untuk stempel waktu pesan pelacakan, alih-alih timer sistem, seperti ketika parameter Tracelog -UsePerfCounter digunakan. Untuk informasi tentang perintah Tracelog, lihat Sintaks Perintah Tracelog.

-seq
Menampilkan nomor urutan lokal atau global dalam awalan pesan pelacakan. Jika nomor urut tidak direkam dalam pesan, bidang tidak diinisialisasi, atau diisi dengan nol atau "f"s.

-Ods
Mengirim pesan pelacakan yang diformat ke debugger untuk ditampilkan.

-Gmt
Menampilkan stempel waktu pada setiap pesan jejak di Greenwich Mean Time (GMT).

Opsi ini hanya memengaruhi file output Tracefmt. Ini tidak mengonversi stempel waktu dalam file log jejak peristiwa (.etl). Zona waktu log jejak ditampilkan saat Anda mengirimkan perintah Tracefmt.

-Utc
Menampilkan stempel waktu pada setiap pesan jejak dalam Waktu Universal Terkoordinasi (UTC). UTC hampir identik dengan GMT, tetapi mewakili tengah malam sebagai nol.

Opsi ini hanya memengaruhi file output Tracefmt. Ini tidak mengonversi stempel waktu dalam file log jejak peristiwa (.etl). Zona waktu file log jejak ditampilkan saat Anda mengirimkan perintah Tracefmt.

-bekas
Menampilkan tindakan Tracefmt saat terjadi. Informasi ini berguna ketika pemformatan salah atau ketika Tracefmt melaporkan kesalahan atau pengecualian.

Tampilan pelacakan dapat ekstensif. Pertimbangkan untuk mengalihkan output Tracefmt ke file teks untuk pemeriksaan nanti.

-v
Penyedehanaan kata. Menampilkan informasi terperinci di jendela Prompt Perintah saat Tracefmt memproses setiap blok atau buffer pesan pelacakan. Gunakan opsi ini saat Anda mencurigai kerusakan atau inkonsistensi file.

Komentar

Menemukan file TMF

Jika Anda menghilangkan parameter -i , Tracefmt menggunakan metode berikut untuk menemukan file TMF. Metode dicantumkan agar Tracefmt menggunakannya.

  • Parameter -tmf .

  • Parameter -p .

  • Variabel lingkungan %TRACE_FORMAT_SEARCH_PATH%.

  • Default.tmf, file yang disertakan dalam WDK.

Jika Tracefmt tidak dapat menemukan file TMF, atau file TMF tidak menyertakan informasi pemformatan untuk pesan pelacakan, Tracefmt tidak dapat menampilkan pesan. Sebaliknya, ia menulis pesan kesalahan berikut sebagai pengganti pesan pelacakan

No Format Information found.

Pengecualian Dimunculkan

Jika Tracefmt tidak dapat memformat parameter pesan pelacakan, tracefmt akan menimbulkan pengecualian dan menampilkan pesan seperti:

*****FormatMessage Header(Header) of EventTrace, parameter 23 raised an exception*****

Jika Anda melihat pengecualian serupa, tinjau definisi pesan dalam kode sumber, dengan perhatian khusus pada jenis variabel yang ditentukan pengguna. Untuk informasi selengkapnya, lihat DoTraceMessage.

File TMF dengan nama file non-GUID

Jika nama file TMF bukan GUID pesan, Anda harus menggunakan parameter -tmf untuk mengidentifikasi file dan memasukkan jalur yang sepenuhnya memenuhi syarat ke file.

Memformat pesan pelacakan NT Kernel Logger

Untuk memformat pesan dari sesi pelacakan NT Kernel Logger atau sesi pelacakan Global Logger, gunakan parameter -tmf untuk menentukan file system.tmf, file format pesan pelacakan yang disertakan dalam WDK..

Memformat pesan pelacakan dari sesi pelacakan real-time

Saat Anda menggunakan parameter -rt (real-time), Tracefmt menampilkan pesan yang mengonfirmasi bahwa parameter tersebut berada dalam mode real time, lalu menunggu pesan pelacakan dari penyedia pelacakan yang ditentukan. Ini tidak kembali ke prompt perintah sampai sesi pelacakan berhenti.

Memformat stempel waktu QPC

Tracefmt tidak memformat nilai jam penghitung kinerja sistem (QueryPerformanceCounter) dengan benar. Jika Anda menggunakan waktu resolusi tinggi ini, gunakan Tracerpt, alat yang disertakan dalam Windows, untuk memformat pesan pelacakan. Untuk informasi selengkapnya, lihat deskripsi parameter -UsePerfCounter di Sintaks Perintah Tracelog.

Pesan pelacakan di luar urutan

Jika Anda melihat file pesan pelacakan pada komputer yang menjalankan Windows XP, tampilan mungkin menampilkan pesan pelacakan yang tidak berurutan. Untuk memperbaiki masalah ini, Anda dapat menggunakan opsi nomor urut saat memulai sesi pelacakan dan melihat jejak menggunakan Tracefmt. Anda kemudian dapat melihat jejak dengan Traceview dan mengurutkan sesuai dengan nomor urutan. Anda juga dapat melihat jejak pada komputer yang menjalankan Windows Server 2003 atau versi Windows yang lebih baru.