Tipo complesso ChannelPublishingType

Definisce le proprietà di registrazione per la sessione usata dal canale.

<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>

Elementi figlio

Elemento	Tipo	Descrizione
Buffersize	UInt32Type	Quantità di memoria, in kilobyte, da allocare per ogni buffer. Se si prevede una frequenza di eventi relativamente bassa, le dimensioni del buffer devono essere impostate sulle dimensioni della pagina di memoria. Se si prevede che la frequenza degli eventi sia relativamente elevata, è necessario specificare una dimensione del buffer maggiore e aumentare il numero massimo di buffer. Le dimensioni del buffer influiscono sulla frequenza di riempimento dei buffer e deve essere scaricata. Anche se una dimensione di buffer ridotta richiede meno memoria, aumenta la frequenza in cui devono essere scaricati i buffer. Le dimensioni predefinite del buffer per i canali di analisi e debug sono 4 KB e per Amministrazione e operative è di 64 KB.
clockType		Risoluzione dell'orologio da usare quando si registra il timestamp per ogni evento. È possibile specificare SystemTime o QPC. SystemTime fornisce un timestamp a bassa risoluzione (10 millisecondi), ma è relativamente meno costoso da recuperare. Il valore predefinito è SystemTime. Il contatore delle prestazioni delle query (QPC) offre un timestamp ad alta risoluzione (100 nanosecondi), ma è relativamente più costoso da recuperare. È consigliabile QPC se si dispone di tassi di evento elevati o se il consumer unisce eventi da buffer diversi.
controlGuid	GUIDType	Identifica il GUID della sessione per una sessione ETW che contiene eventi WPP. Questa impostazione è consentita solo per i canali di tipo Debug. Questi canali non possono essere completamente abilitati con parole chiave impostate su zero (0x0000000000000000). Devono essere abilitati con parole chiave impostate su 0xffffffffffffffff.
fileMax	UInt32Type	Numero massimo di volte in cui si vuole che il servizio crei un nuovo file di log quando il canale è abilitato (include quando il computer viene riavviato). Se il valore è 0 o 1, il servizio sovrascriverà il file di log ogni volta che il canale è abilitato e gli eventi precedenti verranno persi. Se il valore è maggiore di 1, il servizio creerà un nuovo file di log ogni volta che il canale è abilitato per mantenere gli eventi. Il valore predefinito è 1 e il massimo che è possibile specificare è 16. Il servizio aggiunge un numero decimale a tre cifre compreso tra 0 e fileMax 1 a ogni nome di file. Ad esempio, filename.etl.xxx, dove xxx è il numero decimale di tre cifre. I file si trovano in %windir%\System32\winevt\Logs.
Parole chiavi	UInt64Type	Maschera di bit che determina la categoria di eventi scritti nel canale. Se il valore dell'attributo parole chiave è 0, tutti gli eventi scritti dal provider vengono scritti nel canale; in caso contrario, solo gli eventi che hanno definito una parola chiave inclusa nella maschera bit delle parole chiave vengono scritti nel canale. Il valore predefinito è 0. I canali di debug con il set di attributi controlGuid devono impostare l'attributo parole chiave su 0xFFFFFFFFFFFFFFFF. La sessione passa il valore delle parole chiave al provider quando abilita il provider.
Latenza	UInt32Type	Tempo di attesa prima di scaricare i buffer, in millisecondi. Se zero, ETW scarica i buffer non appena diventano completi. Se non è zero, ETW scarica tutti i buffer che contengono eventi in base al valore anche se il buffer non è pieno. In genere, si desidera scaricare i buffer solo quando diventano completi. Forzare i buffer da scaricare può aumentare le dimensioni del file di log con spazio buffer non riempito. Il valore predefinito è 1 secondo per i log Amministrazione e operativi e 5 secondi per i log analitici e di debug.
Livello	UInt8Type	Livello di gravità degli eventi da scrivere nel canale. Il servizio scrive gli eventi nel canale con un valore di livello minore o uguale al valore specificato. Il valore predefinito è 0, ovvero registrare gli eventi con qualsiasi valore di livello. La sessione passa il valore di livello al provider quando abilita il provider.
maxBuffers	UInt32Type	Numero massimo di buffer da allocare per la sessione. In genere, questo valore è il numero minimo di buffer più venti. Questo valore deve essere maggiore o uguale al valore specificato per minBuffers. Il numero massimo predefinito di buffer per i canali di analisi e debug è di 10 KB e per Amministrazione e operativo è di 64 KB.
minBuffers	UInt32Type	Numero minimo di buffer da allocare per la sessione. Il valore predefinito è zero.
sidType		Determina se includere un identificatore di sicurezza (SID) dell'entità con ogni evento scritto nel canale. Per includere il SID con l'evento, impostare questo attributo su "Pubblicazione". Il SID viene impostato in base all'identità del thread al momento della scrittura dell'evento. Se non si vuole includere il SID con l'evento, impostare questo attributo su "Nessuno". Il valore predefinito è "Pubblicazione".

Commenti

È possibile specificare queste informazioni di pubblicazione per i tipi di canale analisi e debug o per qualsiasi canale che specifica l'isolamento personalizzato.

Anche se è possibile specificare parole chiave e livello, è consigliabile considerare che questi saranno gli unici eventi ricevuti dal provider per tale canale.

Quando un buffer è pieno, ETW scarica il buffer nel file di log. Se i buffer vengono riempiti più velocemente di quanto possano essere scaricati, i nuovi buffer vengono allocati e aggiunti al pool di buffer della sessione, fino al numero massimo specificato. Oltre questo limite, la sessione elimina gli eventi in ingresso fino a quando non diventa disponibile un buffer.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]