Bagikan melalui


Sesi

Windows Performance Recorder (WPR) memperluas Pelacakan Peristiwa untuk Windows (ETW). Sesi pengelogan ETW adalah kumpulan buffer dalam memori yang menerima peristiwa melalui antarmuka pemrograman aplikasi Penyedia ETW (API). Buffer ini biasanya non-halaman dan dikelola oleh kernel. ETW menetapkan buffer untuk setiap prosesor. Pembuatan peristiwa dan buffering ETW bebas kunci untuk memungkinkan ETW mencatat semua jenis peristiwa.

Setiap kali ETW memanggil metode EventWrite , ETW mencadangkan ruang di buffer saat ini yang telah dialokasikan ETW untuk prosesor yang menjalankan utas panggilan. Kemudian, ETW menyalin header peristiwa dan data pengguna ke ruang tersebut. Ketika buffer penuh, ETW menyiram buffer ke file log sesi pengelogan atau konsumen streaming real-time. ETW kemudian menetapkan buffer gratis ke prosesor tersebut.

Jika throughput pengelogan melebihi kemampuan flusher ke buffer gratis, semua ruang buffer yang tersedia dalam sesi pengelogan mungkin menjadi tidak tersedia. Misalnya, ini mungkin terjadi karena throughput tulis disk lebih rendah dari throughput peristiwa masuk. Hal ini menyebabkan EventWrite memunculkan kesalahan ERROR_NOT_ENOUGH_MEMORY dan kehilangan data peristiwa. Dalam kasus seperti itu, ETW menaikkan properti EventsLost dari sesi pengelogan sehingga konsumen dapat melihat kehilangan data.

Untuk informasi selengkapnya tentang cara menghindari kehilangan peristiwa dalam rekaman, lihat Menghindari Peristiwa yang Hilang.

Pengelogan ke Memori atau ke File

Anda dapat mengonfigurasi profil untuk merekam data peristiwa ke buffer dalam memori atau ke file. Mode buffering adalah sesi melingkar dalam memori. Anda dapat menyimpan konten sesi ini sebagai rekam jepret ke file log jejak peristiwa (ETL) sesuai permintaan. WPR tidak membersihkan konten ruang buffer dalam memori saat Anda menyimpan konten.

Anda dapat membiarkan sesi mode buffering terus-menerus. Ini sangat berguna jika Anda tidak tahu kapan perilaku minat akan terjadi. Pilih mode buffering ketika ruang buffer melingkar yang diperlukan cukup kecil untuk disimpan dalam memori. File log berurutan paling baik untuk skenario terkontrol. Misalnya, Anda dapat menggunakan file log berurutan untuk pengujian regresi atau ketika terjadinya perilaku minat lebih mudah diprediksi.

Untuk informasi selengkapnya tentang opsi pengelogan, lihat Mode Pengelogan.

Profil Perekaman

Profil rekaman mengontrol setiap sesi. Profil dapat berupa profil bawaan atau profil yang ditentukan pengguna. Untuk informasi selengkapnya, lihat Profil Perekaman.

Ukuran Buffer

Ukuran buffer penting untuk mengontrol efisiensi I/O dan memastikan bahwa WPR tidak melewati peristiwa besar. Buffer yang sangat kecil dapat mengurangi efisiensi penulisan I/O. Kami merekomendasikan ukuran buffer minimum 64 KB atau 128 KB untuk mempromosikan performa penulisan yang baik dan untuk mengurangi overhead disk dan peristiwa yang hilang. Ukuran buffer menentukan durasi maksimum rekaman. ETW membatasi ukuran peristiwa terbesar hingga sekitar 64 KB.

Kolektor

Anda harus menentukan pengumpul sistem dan satu atau beberapa pengumpul peristiwa untuk sesi di profil rekaman. Nama pengumpul harus unik untuk sistem dan sistem harus memiliki akses tulis eksklusif ke file log. Nama file log juga harus unik di antara nama file semua kolektor. WPR tidak memperluas variabel lingkungan, sehingga jalur ke file log harus ditentukan tanpa variabel lingkungan. Untuk informasi selengkapnya, lihat 1. Definisi Kolektor.

Penyedia

Sesi pengelogan dikumpulkan dari sekumpulan penyedia sistem dan peristiwa yang ditentukan. Ini adalah item penting untuk dikonfigurasi berdasarkan per sesi. Sebagian besar penyedia dapat memiliki hubungan banyak ke banyak dengan sesi. Penyedia khusus diperlukan untuk beberapa peristiwa, seperti kernel atau peristiwa tumpukan. Untuk informasi selengkapnya, lihat Penyedia.

Fitur WPR

Skenario Umum WPR

Profil Perekaman

Buffer

BufferSize