Perintah Kontrol TraceView

Catatan

Opsi baris perintah TraceView tidak digunakan lagi. Gunakan tracepdb.exe dan tracefmt.exe untuk mengurai PDB ke dalam file TMF dan mengurai file .etl ke dalam teks, masing-masing.content

Gunakan perintah kontrol Traceview untuk mengelola sesi pelacakan, termasuk memulai dan menghentikan sesi, mengaktifkan dan menonaktifkan penyedia, memperbarui properti sesi pelacakan, dan menghapus buffer pelacakan.

    traceview {-start | -stop | -update | -enable | -disable | -flush | -q} SessionName [Parameters]

    traceview {-enumguid | -l | -h | -x}

Parameter perintah

Tindakan

Tindakan	Deskripsi
-mulai	Memulai sesi pelacakan yang ditentukan.
-Stop	Menghentikan sesi pelacakan yang ditentukan.
-pemutakhiran	Memperbarui properti untuk sesi pelacakan yang ditentukan.
-mengaktifkan	Mengaktifkan penyedia untuk sesi pelacakan yang ditentukan.
-menonaktifkan	Menonaktifkan penyedia untuk sesi yang ditentukan.
-Flush	Menghapus buffer aktif dari sesi pelacakan yang ditentukan. Flush paksa ini selain flush otomatis yang terjadi ketika buffer penuh dan ketika sesi pelacakan berhenti.
-q	Mengkueri status sesi pelacakan yang ditentukan.
-enumguid	Mencantumkan penyedia pada sistem yang terdaftar dengan Pelacakan Peristiwa untuk Windows (ETW).
-L	Cantumkan semua sesi pelacakan yang berjalan pada komputer.
-x	Menghentikan semua sesi pelacakan.

Parameter

SessionName
Saat digunakan dengan -start, SessionName adalah nama yang Anda pilih untuk mewakili sesi pelacakan. Dengan semua perintah lainnya, SessionName mengidentifikasi sesi pelacakan.

-f [LogFile]
Ketika digunakan dengan -start, -f memulai sesi log pelacakan. LogFile menentukan jalur (opsional) dan nama file file dari file log jejak peristiwa (.etl). Defaultnya adalah C:\LogFile.etl.

Ketika digunakan dengan -update, -f mengirim semua pesan pelacakan baru hanya ke log jejak yang ditentukan. Gunakan parameter ini untuk mengonversi sesi pelacakan real-time ke sesi log jejak atau untuk memulai log jejak baru untuk sesi log jejak yang ada. Untuk mengirim pesan pelacakan ke konsumen pelacakan real-time dan ke log pelacakan, gunakan parameter -rt dan -f dalam perintah -update .

-Rt
Ketika digunakan dengan -start, -rt memulai sesi pelacakan real-time (Sesi log jejak (-f) adalah default.) Jika Anda menggunakan -rt dan -f dalam perintah -start , pesan jejak dikirim ke konsumen pelacakan dan ke file log pelacakan peristiwa.

Ketika digunakan dengan -update, -rt menambahkan pengiriman pesan real-time ke sesi log jejak. Semua pesan jejak baru dikirim langsung ke konsumen pelacakan (seperti dalam sesi pelacakan real-time), selain log jejak.

-guid {#GUID | GUIDFile}
Menentukan satu atau beberapa penyedia pelacakan. Gunakan dengan -start untuk mengaktifkan penyedia untuk sesi pelacakan. Gunakan dengan -enable untuk mengaktifkan penyedia atau untuk mengubah nilai -flag atau -level mereka. Gunakan dengan -disable untuk menentukan penyedia yang akan dinonaktifkan.

GUID dapat menentukan satu GUID kontrol (sebelumnya dengan tanda angka (#)) atau jalur (opsional) dan nama file file teks, seperti file GUID kontrol (.ctl), yang berisi GUID kontrol dari satu atau beberapa penyedia pelacakan.

Jika Anda menghilangkan parameter -guid dari perintah -start , TraceView memulai sesi pelacakan NT Kernel Logger.

TraceView meneruskan nilai subparameter berikut ke penyedia yang ditentukan.

Parameter	Deskripsi
SessionName	Saat digunakan dengan -start, SessionName adalah nama yang Anda pilih untuk mewakili sesi pelacakan. Dengan semua perintah lainnya, SessionName mengidentifikasi sesi pelacakan.
-f \[LogFile\]	Ketika digunakan dengan -start, -f memulai sesi log pelacakan. LogFile menentukan jalur (opsional) dan nama file file dari file log jejak peristiwa (.etl). Defaultnya adalah C:\\LogFile.etl. Ketika digunakan dengan -update, -f mengirim semua pesan pelacakan baru hanya ke [jejak log] yang ditentukan(trace-log.md). Gunakan parameter ini untuk mengonversi sesi pelacakan real-time ke sesi log jejak atau untuk memulai log jejak baru untuk sesi log jejak yang ada. Untuk mengirim pesan pelacakan ke konsumen pelacakan real-time dan ke log pelacakan, gunakan parameter -rt dan -f dalam perintah -update .
-Rt	Ketika digunakan dengan -start, -rt memulai sesi pelacakan real-time (Sesi log jejak (-f) adalah default.) Jika Anda menggunakan -rt dan -f dalam perintah -start , pesan jejak dikirim ke konsumen pelacakan dan ke file log pelacakan peristiwa. Ketika digunakan dengan -update, -rt menambahkan pengiriman pesan real-time ke sesi log jejak. Semua pesan jejak baru dikirim langsung ke konsumen pelacakan (seperti dalam sesi pelacakan real-time), selain [log jejak](trace-log.md).
-guid {\#GUID | GUIDFile}	Menentukan satu atau beberapa penyedia pelacakan. Gunakan dengan -start untuk mengaktifkan penyedia untuk sesi pelacakan. Gunakan dengan -enable untuk mengaktifkan penyedia atau untuk mengubah nilai -flag atau -level mereka. Gunakan dengan -disable untuk menentukan penyedia yang akan dinonaktifkan. GUID dapat menentukan satu [control GUID](control-guid.md) (didahului oleh tanda angka (\#)) atau jalur (opsional) dan nama file file teks, seperti file GUID kontrol (.ctl), yang berisi GUID kontrol dari satu atau beberapa penyedia pelacakan. Jika Anda menghilangkan parameter -guid dari perintah -start , TraceView memulai [NT Kernel Logger trace session](nt-kernel-logger-trace-session.md).

TraceView meneruskan nilai subparameter berikut ke penyedia yang ditentukan:

-b BufferSize
Menentukan ukuran, dalam KB, dari setiap buffer yang dialokasikan untuk sesi pelacakan. Gunakan hanya dengan -start.

Nilai default ditentukan oleh jumlah prosesor, jumlah memori fisik, dan sistem operasi yang digunakan.

-Min NumberOfBuffers
Menentukan jumlah buffer yang awalnya dialokasikan untuk menyimpan pesan pelacakan. Gunakan hanya dengan -start.

Nilai default ditentukan oleh jumlah prosesor, jumlah memori fisik, dan sistem operasi yang digunakan.

-Maks NumberOfBuffers
Ketika digunakan dengan -start, -max menentukan jumlah maksimum buffer yang dialokasikan untuk sesi pelacakan. Nilai default ditentukan oleh jumlah prosesor, jumlah memori fisik, dan sistem operasi yang digunakan.

Ketika digunakan dengan -update, -max mengubah jumlah maksimum buffer yang dialokasikan untuk sesi pelacakan.

-Ft FlushTime
Ketika digunakan dengan -start, -ft menentukan seberapa sering, dalam detik, buffer pesan pelacakan dibersihkan. Ketika digunakan dengan -update, -ft mengubah waktu flush ke waktu yang ditentukan.

Waktu flush minimum adalah 1 detik. Nilai defaultnya adalah 0 (tidak ada flush paksa).

Flush paksa ini selain flush yang terjadi secara otomatis setiap kali buffer pesan pelacakan penuh dan ketika sesi pelacakan berhenti.

Lihat juga: -flush.

-Paged
Menggunakan memori yang dapat di-pageable untuk buffer pesan pelacakan. Secara default, pelacakan peristiwa menggunakan memori yang tidak dapat dihapus untuk buffer. Gunakan hanya dengan -start.

Jangan gunakan parameter ini ketika penyedia adalah driver yang mungkin menghasilkan pesan pelacakan pada IRQL yang lebih besar dari DISPATCH_LEVEL.

Parameter ini tidak didukung di Windows 2000.

-seq MaxFileSize
Menentukan pengelogan berurutan (di akhir file, hentikan perekaman peristiwa) ke file log jejak peristiwa (.etl). Gunakan hanya dengan -start.

MaxFileSize menentukan ukuran maksimum file dalam MB. Tanpa nilai MaxFileSize, parameter ini diabaikan.

Pengelogan berurutan adalah default, tetapi Anda dapat menggunakan parameter ini untuk mengatur ukuran file maksimum atau untuk menggunakan -prealloc. Tanpa parameter ini, tidak ada batas ukuran file.

-Cir MaxFileSize
Menentukan pengelogan melingkar (di akhir file, rekam pesan baru melalui pesan terlama) dalam file log jejak peristiwa (.etl). Gunakan hanya dengan -start.

MaxFileSize menentukan ukuran maksimum file dalam MB. Tanpa nilai MaxFileSize, parameter ini diabaikan.

Defaultnya adalah pengelogan berurutan tanpa batas ukuran file.

-prealloc
Mencadangkan ruang untuk file log jejak peristiwa (.etl) sebelum mengalokasikannya. Gunakan hanya dengan -start.

Parameter ini memerlukan -seq atau -cir dengan MaxFileSize. Ini tidak valid dengan -newfile.

Bendera mewakili nilai bendera yang ditentukan dalam penyedia pelacakan, dalam format desimal atau heksadesimal. Nilai default adalah 0. Nilai dari 0x01000000 hingga 0xFF000000 dicadangkan untuk digunakan di masa mendatang.

Arti bendera didefinisikan secara independen oleh setiap penyedia pelacakan. Biasanya, bendera mewakili tingkat pelaporan yang semakin terperinci.

Dalam perintah -start, nilai bendera berlaku untuk semua penyedia pelacakan dalam sesi pelacakan. Untuk mengatur bendera yang berbeda untuk setiap penyedia pelacakan, gunakan perintah -enable terpisah untuk setiap penyedia pelacakan.

Subparameter dari -guid	Deskripsi
-bendera bendera
-level	Menentukan tingkat pelacakan untuk penyedia dalam sesi pelacakan. Tingkat menentukan peristiwa mana yang dihasilkan penyedia pelacakan. Tingkat mewakili nilai tingkat dalam format desimal atau heksadesimal. Nilai default adalah 0. Arti nilai tingkat didefinisikan secara independen oleh setiap penyedia pelacakan. Biasanya, tingkat pelacakan mewakili tingkat keparahan peristiwa (informasi, peringatan, atau kesalahan). Dalam perintah -start, nilai tingkat berlaku untuk semua penyedia pelacakan dalam sesi pelacakan. Untuk mengatur tingkat yang berbeda untuk setiap penyedia pelacakan, gunakan perintah -enable terpisah untuk setiap penyedia pelacakan.

ParameterDeskripsi

-b BufferSize	Menentukan ukuran, dalam KB, dari setiap buffer yang dialokasikan untuk sesi pelacakan. Gunakan hanya dengan -start. Nilai default ditentukan oleh jumlah prosesor, jumlah memori fisik, dan sistem operasi yang digunakan.
-min NumberOfBuffers	Menentukan jumlah buffer yang awalnya dialokasikan untuk menyimpan pesan pelacakan. Gunakan hanya dengan -start. Nilai default ditentukan oleh jumlah prosesor, jumlah memori fisik, dan sistem operasi yang digunakan.
-max NumberOfBuffers	Ketika digunakan dengan -start, -max menentukan jumlah maksimum buffer yang dialokasikan untuk sesi pelacakan. Nilai default ditentukan oleh jumlah prosesor, jumlah memori fisik, dan sistem operasi yang digunakan. Ketika digunakan dengan -update, -max mengubah jumlah maksimum buffer yang dialokasikan untuk sesi pelacakan.
-ft FlushTime	Ketika digunakan dengan -start, -ft menentukan seberapa sering, dalam detik, buffer pesan pelacakan dibersihkan. Ketika digunakan dengan -update, -ft mengubah waktu flush ke waktu yang ditentukan. Waktu flush minimum adalah 1 detik. Nilai defaultnya adalah 0 (tidak ada flush paksa). Flush paksa ini selain flush yang terjadi secara otomatis setiap kali buffer pesan pelacakan penuh dan ketika sesi pelacakan berhenti. Lihat juga: -flush.
-age AgeLimit	Ketika digunakan dengan -start, -age menentukan berapa lama (dalam menit) buffer pelacakan yang tidak digunakan disimpan sebelum dibebaskan. Ketika digunakan dengan -update, -age mengubah batas usia ke nilai yang ditentukan. Batas Usia menentukan berapa lama (dalam menit) buffer pelacakan yang tidak digunakan disimpan sebelum dibebaskan. Defaultnya adalah 15 menit. Parameter ini hanya berlaku di Windows 2000.
-Paged	Menggunakan memori yang dapat di-pageable untuk buffer pesan pelacakan. Secara default, pelacakan peristiwa menggunakan memori yang tidak dapat dihapus untuk buffer. Gunakan hanya dengan -start. Jangan gunakan parameter ini ketika penyedia adalah driver yang mungkin menghasilkan pesan jejak di IRQL yang lebih besar dari DISPATCH\_LEVEL. Parameter ini tidak didukung di Windows 2000.
-seq MaxFileSize	Menentukan pengelogan berurutan (di akhir file, hentikan perekaman peristiwa) ke file log jejak peristiwa (.etl). Gunakan hanya dengan -start. MaxFileSize menentukan ukuran maksimum file dalam MB. Tanpa nilai MaxFileSize, parameter ini diabaikan. Pengelogan berurutan adalah default, tetapi Anda dapat menggunakan parameter ini untuk mengatur ukuran file maksimum atau untuk menggunakan -prealloc. Tanpa parameter ini, tidak ada batas ukuran file.
-cir MaxFileSize	Menentukan pengelogan melingkar (di akhir file, rekam pesan baru melalui pesan terlama) dalam file log jejak peristiwa (.etl). Gunakan hanya dengan -start. MaxFileSize menentukan ukuran maksimum file dalam MB. Tanpa nilai MaxFileSize, parameter ini diabaikan. Defaultnya adalah pengelogan berurutan tanpa batas ukuran file.
-prealloc	Mencadangkan ruang untuk file log jejak peristiwa (.etl) sebelum mengalokasikannya. Gunakan hanya dengan -start. Parameter ini memerlukan -seq atau -cir dengan MaxFileSize. Ini tidak valid dengan -newfile. Sistem membuat file log jejak peristiwa (.etl) dengan ukuran yang sama dengan nilai MaxFileSize yang ditentukan dengan menggunakan parameter -seq atau -cir . Saat Anda menghentikan sesi, sesi akan mengurangi file log ke ukuran kontennya.
-newfile MaxFileSize	Membuat file log jejak peristiwa (.etl) baru setiap kali file yang ada mencapai MaxFileSize. Gunakan hanya dengan -start. MaxFileSize menentukan ukuran maksimum setiap file log dalam MB. Tanpa nilai MaxFileSize, parameter ini diabaikan. Saat menggunakan -newfile, Anda juga harus menggunakan parameter -f LogFile , dan nilai LogFile harus berupa nama yang menyertakan karakter %d menunjukkan pola desimal--misalnya, trace%d.etl. Jika tidak, perintah gagal dengan ERROR\_INVALID\_NAME. Windows menambahkan nilai desimal dalam nama file setiap kali membuat file baru. Parameter ini tidak valid dengan preallocation (-prealloc logging (-cir), dengan sesi NT Kernel Logger, atau untuk sesi pelacakan privat. Ini tidak didukung di Windows 2000.
-Menambahkan	Menambahkan pesan pelacakan ke file log jejak peristiwa (.etl) yang ada. Defaultnya adalah membuat file baru. Gunakan hanya dengan -start. Parameter ini hanya valid pada file berurutan dan hanya ketika -f digunakan dan -rt tidak digunakan. Ini tidak didukung di Windows 2000.
-Kd	Mengalihkan pesan jejak ke KD atau Windbg, mana pun yang terlampir. Parameter ini juga mengatur ukuran buffer pelacakan ke 3 KB, ukuran buffer maksimum untuk debugger, dan mengabaikan parameter -b apa pun dalam perintah. Gunakan hanya dengan -start.

Komentar

Perintah traceview tanpa parameter membuka jendela TraceView.

Anda dapat menggunakan perintah TraceView -start untuk memulai sesi pelacakan Global Logger. Untuk melakukannya, gunakan format perintah berikut. Tidak seperti perintah lain, kata "GlobalLogger" dalam format perintah ini peka huruf besar/kecil.

traceview -start GlobalLogger [parameters]