Tipe Kompleks ChannelType

Menentukan saluran tempat penyedia dapat mencatat peristiwa.

<xs:complexType name="ChannelType"
    mixed="true"
>
    <xs:sequence>
        <xs:element name="logging"
            type="ChannelLoggingType"
            minOccurs="0"
         />
        <xs:element name="publishing"
            type="ChannelPublishingType"
            minOccurs="0"
         />
    </xs:sequence>
    <xs:attribute name="name"
        type="anyURI"
        use="required"
     />
    <xs:attribute name="chid"
        type="token"
        use="optional"
     />
    <xs:attribute name="type"
        type="string"
        use="required"
     />
    <xs:attribute name="symbol"
        type="CSymbolType"
        use="optional"
     />
    <xs:attribute name="access"
        type="string"
        use="optional"
     />
    <xs:attribute name="isolation"
        type="string"
        use="optional"
     />
    <xs:attribute name="enabled"
        type="boolean"
        default="false"
        use="optional"
     />
    <xs:attribute name="value"
        type="UInt8Type"
        use="optional"
     />
    <xs:attribute name="message"
        type="string"
        use="optional"
     />
</xs:complexType>

Elemen anak

Elemen	Jenis	Deskripsi
Penebangan	ChannelLoggingType	Menentukan properti file log yang mendukung saluran, seperti kapasitasnya dan apakah file log berurutan atau melingkar.
Penerbitan	ChannelPublishingType	Menentukan properti pengelogan untuk sesi yang digunakan saluran. Hanya saluran dan saluran Debug dan Analitik yang menggunakan isolasi Kustom yang dapat menentukan properti pengelogan untuk sesi mereka.

Atribut

Nama	Jenis	Deskripsi
akses	string	Deskriptor akses Security Descriptor Definition Language (SDDL) yang mengontrol akses ke file log yang mendukung saluran. Jika atribut isolasi diatur ke Aplikasi atau Sistem, deskriptor akses mengontrol akses baca ke file (izin tulis diabaikan). Jika atribut isolasi diatur ke Kustom, deskriptor akses mengontrol akses tulis ke saluran dan akses baca ke file.
chid	token	Pengidentifikasi yang secara unik mengidentifikasi saluran dalam daftar saluran yang ditentukan atau diimpor oleh penyedia. Gunakan nilai ini saat mereferensikan saluran dalam suatu peristiwa. Jika Anda tidak menentukan pengidentifikasi saluran, gunakan nama saluran untuk mereferensikan saluran ini dalam definisi peristiwa.
diaktifkan	boolean	Menentukan apakah saluran diaktifkan. Atur ke true untuk mengizinkan pengelogan ke saluran; jika tidak, salah. Defaultnya adalah false (pengelogan dinonaktifkan). Karena jenis saluran Debug dan Analitik adalah saluran volume tinggi, Anda harus mengaktifkan saluran hanya saat menyelidiki masalah dengan komponen yang menulis ke saluran tersebut; jika tidak, saluran harus tetap dinonaktifkan. Setiap kali Anda mengaktifkan saluran Debug dan Analitik, layanan akan menghapus peristiwa dari saluran.
Isolasi	string	Nilai isolasi menentukan izin akses default untuk saluran. Anda dapat menentukan satu atau beberapa nilai berikut: Aplikasi Sistem Kustom Isolasi default adalah Aplikasi. Izin default untuk Aplikasi (ditampilkan menggunakan SDDL): Teks L"O:BAG:SYD:" L"(A;;0xf0007;;;SY)" // local system (read, write, clear) L"(A;;0x7;;;BA)" // built-in admins (read, write, clear) L"(A;;0x7;;;SO)" // server operators (read, write, clear) L"(A;;0x3;;;IU)" // INTERACTIVE LOGON (read, write) L"(A;;0x3;;;SU)" // SERVICES LOGON (read, write) L"(A;;0x3;;;S-1-5-3)" // BATCH LOGON (read, write) L"(A;;0x3;;;S-1-5-33)" // write restricted service (read, write) L"(A;;0x1;;;S-1-5-32-573)"; // event log readers (read) Izin default untuk Sistem (ditampilkan menggunakan SDDL): Teks L"O:BAG:SYD:" L"(A;;0xf0007;;;SY)" // local system (read, write, clear) L"(A;;0x7;;;BA)" // built-in admins (read, write, clear) L"(A;;0x3;;;BO)" // backup operators (read, write) L"(A;;0x5;;;SO)" // server operators (read, clear) L"(A;;0x1;;;IU)" // INTERACTIVE LOGON (read) L"(A;;0x3;;;SU)" // SERVICES LOGON (read, write) L"(A;;0x1;;;S-1-5-3)" // BATCH LOGON (read) L"(A;;0x2;;;S-1-5-33)" // write restricted service (write) L"(A;;0x1;;;S-1-5-32-573)"; // event log readers (read) Izin default untuk isolasi Kustom sama dengan Aplikasi. Saluran yang menentukan Isolasi aplikasi menggunakan sesi ETW yang sama. Hal yang sama berlaku untuk isolasi Sistem . Namun, jika Anda menentukan Isolasi kustom , layanan membuat sesi ETW terpisah untuk saluran. Menggunakan isolasi Kustom memungkinkan Anda mengontrol izin akses untuk saluran dan file cadangan. Karena hanya ada 64 sesi ETW yang tersedia, Anda harus membatasi penggunaan Isolasi kustom Anda.
pesan	string	Nama tampilan yang dilokalkan untuk saluran. String pesan mereferensikan string yang dilokalkan di bagian stringTable dari manifes.
nama	anyURI	Nama saluran. Nama harus unik dalam daftar saluran yang digunakan penyedia. Konvensi untuk penamaan saluran adalah menambahkan jenis saluran ke nama penyedia. Contohnya. jika nama penyedia adalah Company-Product-Component dan Anda mendefinisikan saluran operasional, namanya adalah Company-Product-Component/Operational. Nama saluran harus kurang dari 255 karakter dan tidak boleh berisi karakter berikut: '>', '<', '&', '"', '|', '\', ':', ''', '?', '*', atau karakter dengan kode kurang dari 31.
simbol	CSymbolType	Simbol yang digunakan untuk mereferensikan saluran di aplikasi Anda. Pengkompilasi Pesan (MC.exe) menggunakan simbol untuk membuat konstanta untuk saluran dalam file header yang dihasilkan pengkompilasi. Jika Anda tidak menentukan simbol, pengkompilasi akan menghasilkan nama untuk Anda.
jenis	string	Mengidentifikasi jenis saluran. Anda bisa menentukan salah satu jenis berikut ini: Admin Operasional Analitik Debug Admin jenis saluran mendukung peristiwa yang menargetkan pengguna akhir, administrator, dan personel dukungan. Peristiwa yang ditulis ke saluran Admin harus memiliki solusi yang terdefinisi dengan baik di mana administrator dapat bertindak. Contoh peristiwa admin adalah peristiwa yang terjadi ketika aplikasi gagal tersambung ke printer. Peristiwa ini di dokumentasikan dengan baik atau memiliki pesan yang terkait dengannya yang memberi pembaca instruksi langsung tentang apa yang harus dilakukan untuk memperbaiki masalah. Saluran jenis operasional mendukung peristiwa yang digunakan untuk menganalisis dan mendiagnosis masalah atau kemunculan. Mereka dapat digunakan untuk memicu alat atau tugas berdasarkan masalah atau kemunculannya. Contoh peristiwa operasional adalah peristiwa yang terjadi ketika printer ditambahkan atau dihapus dari sistem. Saluran jenis analitik mendukung peristiwa yang diterbitkan dalam volume tinggi. Mereka menjelaskan operasi program dan menunjukkan masalah yang tidak dapat ditangani oleh intervensi pengguna. Saluran jenis debug mendukung peristiwa yang hanya digunakan oleh pengembang untuk mendiagnosis masalah untuk penelusuran kesalahan. Saluran analitik dan debug dinonaktifkan secara default dan hanya boleh diaktifkan untuk menentukan penyebab masalah. Misalnya, Anda akan mengaktifkan saluran, menjalankan skenario yang menyebabkan masalah, menonaktifkan saluran, lalu mengkueri peristiwa. Perhatikan bahwa mengaktifkan saluran akan menghapus saluran peristiwa yang ada. Jika saluran analitik dan debug menggunakan file dukungan melingkar, Anda harus menonaktifkan saluran untuk mengkueri peristiwanya. Semua saluran Admin menggunakan sesi ETW yang sama; hal yang sama berlaku untuk saluran Operasional. Namun, setiap saluran Analitik dan Debug menggunakan sesi ETW terpisah, yang merupakan alasan lain untuk hanya mengaktifkan jenis saluran ini ketika diperlukan (ada sejumlah terbatas sesi ETW yang tersedia).
nilai	UInt8Type	Pengidentifikasi numerik yang secara unik mengidentifikasi saluran dalam daftar saluran yang ditentukan penyedia. Pengkompilasi pesan menetapkan nilai jika tidak ditentukan.

Keterangan

Jika nama saluran mengikuti konvensi penamaan saluran, Pemantau Peristiwa Windows akan mencantumkan saluran menggunakan string yang mengikuti garis miring terbelakang. Misalnya, jika nama saluran adalah Company-Product-Component/Operational, maka Pemantau Peristiwa akan mencantumkan saluran sebagai Operasional di bawah penyedia Company-Product-Component. Jika tidak, seluruh nama saluran ditampilkan di bawah penyedia. Nama tampilan yang dilokalkan digunakan jika disediakan.

Persyaratan

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

`