Jenis Kompleks ChannelPublishingType

Menentukan properti pengelogan untuk sesi yang digunakan saluran.

<xs:complexType name="ChannelPublishingType">
    <xs:sequence
        minOccurs="0"
    >
        <xs:element name="level"
            type="UInt8Type"
            default="0"
            minOccurs="0"
         />
        <xs:element name="keywords"
            type="UInt64Type"
            default="0"
            minOccurs="0"
         />
        <xs:element name="controlGuid"
            type="GUIDType"
            minOccurs="0"
         />
        <xs:element name="bufferSize"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="minBuffers"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="fileMax"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="maxBuffers"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="latency"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="clockType"
            default="SystemTime"
            minOccurs="0"
        >
            <xs:simpleType>
                <xs:restriction
                    base="xs:string"
                >
                    <xs:enumeration
                        value="SystemTime"
                     />
                    <xs:enumeration
                        value="QPC"
                     />
                </xs:restriction>
            </xs:simpleType>
        </xs:element>
        <xs:element name="sidType"
            minOccurs="0"
        >
            <xs:simpleType>
                <xs:restriction
                    base="xs:string"
                >
                    <xs:enumeration
                        value="None"
                     />
                    <xs:enumeration
                        value="Publishing"
                     />
                </xs:restriction>
            </xs:simpleType>
        </xs:element>
        <xs:any
            processContents="lax"
            minOccurs="0"
            maxOccurs="unbounded"
            namespace="##other"
         />
    </xs:sequence>
    <xs:anyAttribute
        processContents="lax"
        namespace="##other"
     />
</xs:complexType>

Elemen anak

Elemen	Jenis	Deskripsi
bufferSize	UInt32Type	Jumlah memori, dalam kilobyte, untuk dialokasikan untuk setiap buffer. Jika Anda mengharapkan tingkat peristiwa yang relatif rendah, ukuran buffer harus diatur ke ukuran halaman memori. Jika tingkat peristiwa diperkirakan relatif tinggi, Anda harus menentukan ukuran buffer yang lebih besar dan meningkatkan jumlah maksimum buffer. Ukuran buffer mempengaruhi laju di mana buffer terisi dan harus dibersihkan. Meskipun ukuran buffer kecil membutuhkan lebih sedikit memori, itu meningkatkan laju di mana buffer harus dibersihkan. Ukuran buffer default untuk saluran Analitik dan Debug adalah 4 KB dan untuk Admin dan Operasional adalah 64 KB.
clockType		Resolusi jam yang digunakan saat mencatat stempel waktu untuk setiap peristiwa. Anda dapat menentukan SystemTime atau QPC. SystemTime menyediakan stempel waktu resolusi rendah (10 milidetik), tetapi relatif lebih murah untuk diambil. Defaultnya adalah SystemTime. Penghitung kinerja kueri (QPC) menyediakan stempel waktu resolusi tinggi (100 nanodetik) tetapi relatif lebih mahal untuk diambil. Anda harus QPC jika Anda memiliki tingkat peristiwa yang tinggi atau jika konsumen menggabungkan peristiwa dari buffer yang berbeda.
controlGuid	GUIDType	Mengidentifikasi GUID sesi untuk sesi ETW yang berisi peristiwa WPP. Pengaturan ini hanya diperbolehkan untuk saluran jenis Debug. Saluran ini tidak dapat diaktifkan sepenuhnya dengan kata kunci yang diatur ke nol (0x0000000000000000). Mereka harus diaktifkan dengan kata kunci yang diatur ke 0xffffffffffffffff.
fileMax	UInt32Type	Jumlah maksimum berapa kali Anda ingin layanan membuat file log baru ketika saluran diaktifkan (termasuk ketika komputer dimulai ulang). Jika nilainya adalah 0 atau 1, layanan akan menimpa file log setiap kali saluran diaktifkan dan peristiwa sebelumnya akan hilang. Jika nilainya lebih besar dari 1, layanan akan membuat file log baru setiap kali saluran diaktifkan untuk mempertahankan peristiwa. Defaultnya adalah 1 dan maksimum yang dapat Anda tentukan adalah 16. Layanan menambahkan angka desimal tiga digit antara 0 dan fileMax 1 ke setiap nama file. Misalnya, filename.etl.xxx, di mana xxx adalah angka desimal tiga digit. File terletak di %windir%\System32\winevt\Logs.
Kata kunci	UInt64Type	Bitmask yang menentukan kategori peristiwa yang ditulis ke saluran. Jika nilai atribut kata kunci adalah 0, semua peristiwa yang ditulis penyedia ditulis ke saluran; jika tidak, hanya peristiwa yang telah menentukan kata kunci yang disertakan dalam bitmask kata kunci yang ditulis ke saluran. Defaultnya adalah 0. Saluran debug yang memiliki set atribut controlGuid harus mengatur atribut kata kunci ke 0xFFFFFFFFFFFFFFFF. Sesi meneruskan nilai kata kunci ke penyedia saat mengaktifkan penyedia.
Latency	UInt32Type	Waktu untuk menunggu sebelum membersihkan buffer, dalam milidetik. Jika nol, ETW membersihkan buffer segera setelah penuh. Jika bukan nol, ETW membersihkan semua buffer yang berisi peristiwa berdasarkan nilai meskipun buffer tidak penuh. Biasanya, Anda ingin menyiram buffer hanya ketika buffer menjadi penuh. Memaksa buffer untuk memerah dapat meningkatkan ukuran file file log dengan ruang buffer yang tidak terisi. Nilai default adalah 1 detik untuk log Admin dan Operasional dan 5 detik untuk log Analitik dan Debug.
Tingkat	UInt8Type	Tingkat keparahan peristiwa untuk ditulis ke saluran. Layanan menulis peristiwa ke saluran yang memiliki nilai tingkat yang kurang dari atau sama dengan nilai yang ditentukan. Defaultnya adalah 0, yang berarti mencatat peristiwa dengan nilai tingkat apa pun. Sesi meneruskan nilai tingkat ke penyedia saat mengaktifkan penyedia.
maxBuffers	UInt32Type	Jumlah maksimum buffer yang akan dialokasikan untuk sesi. Biasanya, nilai ini adalah jumlah minimum buffer ditambah dua puluh. Nilai ini harus lebih besar dari atau sama dengan nilai yang ditentukan untuk minBuffers. Jumlah maksimum default buffer untuk saluran Analitik dan Debug adalah 10 KB dan untuk Admin dan Operasional adalah 64 KB.
minBuffers	UInt32Type	Jumlah minimum buffer yang akan dialokasikan untuk sesi. Defaultnya adalah nol.
sidType		Menentukan apakah akan menyertakan pengidentifikasi keamanan (SID) utama dengan setiap peristiwa yang ditulis ke saluran. Untuk menyertakan SID dengan peristiwa, atur atribut ini ke "Penerbitan". SID diatur berdasarkan identitas utas pada saat peristiwa ditulis. Jika Anda tidak ingin menyertakan SID dengan peristiwa, atur atribut ini ke "Tidak Ada". Defaultnya adalah "Penerbitan".

Keterangan

Anda dapat menentukan informasi penerbitan ini untuk jenis saluran Analitik dan Debug atau untuk saluran apa pun yang menentukan Isolasi kustom.

Meskipun Anda dapat menentukan tingkat dan kata kunci, Anda harus mempertimbangkan bahwa ini akan menjadi satu-satunya peristiwa yang akan Anda terima dari penyedia untuk saluran tersebut.

Ketika buffer penuh, ETW menghapus buffer ke file log. Jika buffer diisi lebih cepat daripada yang dapat dibersihkan, buffer baru dialokasikan dan ditambahkan ke kumpulan buffer sesi, hingga jumlah maksimum yang ditentukan. Di luar batas ini, sesi membuang peristiwa masuk hingga buffer tersedia.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]