3. Definisi Profil
Profil rekaman Windows Performance Recorder (WPR) disimpan dalam file XML yang memiliki ekstensi .wprp. Definisi profil menggabungkan definisi kolektor dan penyedia dalam file .wprp.
Profil
Anda menentukan profil WPR dengan menggunakan (<Profile> … </Profile> tag XML yang merujuk ke tag XML definisi kolektor dan penyedia yang Anda tentukan dalam file .wprp yang sama atau dengan menggunakan pewarisan dalam file .wprp lain. Setiap tag XML definisi profil harus memiliki atribut berikut:
Id: Pengidentifikasi unik definisi profil. Gunakan konstruksi pengidentifikasi profil berikut:
< Nama>.<DetailLevel>.<LoggingMode>.
Nama: String yang menunjukkan nama profil.
DetailLevel: Atribut yang menentukan apakah definisi profil digunakan untuk pelacakan waktu (Cahaya) atau pelacakan analisis (Verbose).
LoggingMode: Atribut yang menentukan apakah profil mencatat peristiwa ke file berurutan atau ke buffer memori melingkar. Semua profil harus memiliki file dan versi memori dalam file .wprp yang sama.
Deskripsi: Deskripsi tekstual profil yang dilihat pengguna.
WPR mendukung perekaman performa untuk mode pengelogan file dan memori untuk setiap file .wprp kecuali untuk profil aktif/nonaktif. Anda harus masuk/keluar profil ke file, tetapi Anda harus menentukan file dan versi memori. Karena definisi profil tunggal hanya dapat mendukung satu mode pengelogan, mungkin ada dua atau empat definisi profil dalam file .wprp, satu untuk setiap kombinasi mode pengelogan dan tingkat detail. Semua definisi profil dalam satu file .wprp harus memiliki atribut Nama yang sama.
< Nama>.<DetailLevel>.<LoggingMode>
Contoh kode berikut menunjukkan Example1.wprp. File ini berisi dua definisi profil. Elipsis (...) mewakili isi profil.
<Profile
Id="Example1.Verbose.File"
Name="Example1"
DetailLevel="Verbose"
LoggingMode="File"
Description="Example1 profile">
…
</Profile>
<Profile
Id="Example1.Verbose.Memory"
Name="Example1"
DetailLevel="Verbose"
LoggingMode="Memory"
Description="Example1 profile">
…
</Profile>
Contoh kode berikut menunjukkan Example2.wprp. File ini berisi empat definisi profil. Elipsis (...) mewakili isi profil.
<Profile
Id="Example2.Verbose.File"
Name="Example2"
DetailLevel="Verbose"
LoggingMode="File"
Description="Example2 profile">
…
</Profile>
<Profile
Id="Example2.Light.File"
Name="Example2"
DetailLevel="Light"
LoggingMode="File"
Description="Example2 profile">
…
</Profile>
<Profile
Id="Example2.Verbose.Memory"
Name="Example2"
DetailLevel="Verbose"
LoggingMode="Memory"
Description="Example2 profile">
…
</Profile>
<Profile
Id="Example2.Light.Memory"
Name="Example2"
DetailLevel="Light"
LoggingMode="Memory"
Description="Example2 profile">
…
</Profile>
Elemen Kolektor
Elemen Collectors berisi referensi ke sistem dan pengumpul peristiwa yang ditentukan sebelumnya. Elemen SystemCollectorId dan EventCollectorId mengidentifikasi kolektor ini.
Setiap elemen SystemCollectorId dan EventCollectorId berisi atribut Nilai wajib yang menentukan atribut Id pengumpul yang akan digunakan. Setiap elemen SystemCollectorId dan EventCollectorId juga berisi daftar elemen SystemProviderId atau EventCollectorId . Elemen-elemen ini memiliki sintaks yang sama. Namun, elemen-elemen ini mengacu pada penyedia sistem dan peristiwa yang ditentukan sebelumnya.
Anda juga dapat menentukan kolektor dan penyedia di dalam definisi profil.
Contoh Definisi Profil
Contoh kode berikut menunjukkan definisi profil lengkap.
<Profile
Id="Example.Light.File"
Name="Example"
DetailLevel="Light"
LoggingMode="File"
Description="Example profile">
<ProblemCategories>
<ProblemCategory
Value="First Level Triage"/>
</ProblemCategories>
<Collectors>
<SystemCollectorId
Value="WPRSystemCollector">
<!--Enables the system provider for this system collector. -->
<SystemProviderId
Value="system-provider"/>
</SystemCollectorId>
<EventCollectorId
Value="WPREventCollector">
<EventProviders>
<!--Enables two event providers for this event collector. -->
<EventProviderId
Value="Win32K-provider"/>
<EventProviderId
Value="Search-Core-provider"/>
</EventProviders>
</EventCollectorId>
</Collectors>
</Profile>