Komplexer ChannelPublishingType-Typ
Definiert die Protokollierungseigenschaften für die Sitzung, die der Kanal verwendet.
<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>
Untergeordnete Elemente
| Element | type | BESCHREIBUNG |
|---|---|---|
| Buffersize | UInt32Type | Die Arbeitsspeichermenge in Kilobyte, die für jeden Puffer reserviert werden soll. Wenn Sie eine relativ niedrige Ereignisrate erwarten, sollte die Puffergröße auf die Größe der Arbeitsspeicherseite festgelegt werden. Wenn die Ereignisrate relativ hoch sein soll, sollten Sie eine größere Puffergröße angeben und die maximale Anzahl von Puffern erhöhen. Die Puffergröße wirkt sich auf die Rate aus, mit der Puffer auffüllen und geleert werden müssen. Obwohl eine kleine Puffergröße weniger Arbeitsspeicher erfordert, erhöht sie die Rate, mit der Puffer geleert werden müssen. Die Standardpuffergröße für Analyse- und Debugkanäle beträgt 4 KB und für Admin und Operational 64 KB. |
| clockType | Die Uhrauflösung, die beim Protokollieren des Zeitstempels für jedes Ereignis verwendet werden soll. Sie können SystemTime oder QPC angeben. SystemTime bietet einen Zeitstempel mit niedriger Auflösung (10 Millisekunden), ist aber relativ kostengünstiger abzurufen. Der Standardwert ist SystemTime. Der Abfrageleistungsindikator (Query Performance Counter, QPC) bietet einen zeitstempel mit hoher Auflösung (100 Nanosekunden), ist aber im Vergleich teurer abzurufen. Sie sollten QPC verwenden, wenn Sie über hohe Ereignisraten verfügen oder wenn der Consumer Ereignisse aus unterschiedlichen Puffern zusammenführungst. |
|
| controlGuid | GUIDType | Identifiziert die Sitzungs-GUID für eine ETW-Sitzung, die WPP-Ereignisse enthält. Diese Einstellung ist nur für Kanäle vom Typ Debug zulässig. Diese Kanäle können nicht vollständig aktiviert werden, wenn Schlüsselwörter auf 0 (null) festgelegt sind (0x0000000000000000). Sie müssen mit Schlüsselwörtern aktiviert werden, die auf 0xffffffffffffffff. |
| fileMax | UInt32Type | Die maximale Anzahl von Malen, mit denen der Dienst eine neue Protokolldatei erstellen soll, wenn der Kanal aktiviert ist (einschließlich beim Neustart des Computers). Wenn der Wert 0 oder 1 ist, überschreibt der Dienst die Protokolldatei jedes Mal, wenn der Kanal aktiviert ist und die vorherigen Ereignisse verloren gehen. Wenn der Wert größer als 1 ist, erstellt der Dienst bei jeder Aktivierung des Kanals eine neue Protokolldatei, um die Ereignisse zu erhalten. Der Standardwert ist 1, und der Maximalwert, den Sie angeben können, ist 16. Der Dienst fügt eine dreistellige Dezimalzahl zwischen 0 und fileMax 1 an jeden Dateinamen an. Beispiel: Dateiname .etl.xxx, wobei xxx die dreistellige Dezimalzahl ist. Die Dateien befinden sich in %windir% \ System32 \ winevt \ Logs. |
| Schlüsselwörter | UInt64Type | Eine Bitmaske, die die Kategorie der Ereignisse bestimmt, die in den Kanal geschrieben werden. Wenn der Wert des keywords-Attributs 0 ist, werden alle Ereignisse, die der Anbieter schreibt, in den Kanal geschrieben. Andernfalls werden nur Ereignisse, die ein Schlüsselwort definiert haben, das in der Bitmaske der Schlüsselwörter enthalten ist, in den Kanal geschrieben. Die Standardeinstellung ist 0. Debugkanäle, für die das attribut controlGuid festgelegt ist, müssen das Attribut keywords auf 0xFFFFFFFFFFFFFFFF. Die Sitzung übergibt den Wert der Schlüsselwörter an den Anbieter, wenn sie den Anbieter aktiviert. |
| Latenz | UInt32Type | Die Wartezeit vor dem Leeren der Puffer in Millisekunden. Bei 0 (null) leert ETW die Puffer, sobald sie voll sind. Bei einem Wert ungleich 0 (null) leert ETW alle Puffer, die Ereignisse enthalten, basierend auf dem Wert, auch wenn der Puffer nicht voll ist. In der Regel möchten Sie Puffer nur leeren, wenn sie voll sind. Das Erzwingen des Leerens der Puffer kann die Dateigröße der Protokolldatei mit nicht gefüllten Pufferspeichern erhöhen. Der Standardwert ist 1 Sekunde für Administrator- und Betriebsprotokolle und 5 Sekunden für Analyse- und Debugprotokolle. |
| Ebene | UInt8Type | Der Schweregrad der Ereignisse, die in den Kanal geschrieben werden. Der Dienst schreibt Ereignisse in den Kanal, deren Ebene kleiner oder gleich dem angegebenen Wert ist. Der Standardwert ist 0, was bedeutet, dass Ereignisse mit einem beliebigen Levelwert protokolliert werden. Die Sitzung übergibt den Wert der Ebene an den Anbieter, wenn sie den Anbieter aktiviert. |
| maxBuffers | UInt32Type | Die maximale Anzahl von Puffern, die für die Sitzung reserviert werden. In der Regel ist dieser Wert die Mindestanzahl von Puffern plus 20. Dieser Wert muss größer oder gleich dem für minBuffers angegebenen Wert sein. Die maximale Standardanzahl von Puffern für Analyse- und Debugkanäle beträgt 10 KB und für Admin und Operational 64 KB. |
| minBuffers | UInt32Type | Die Mindestanzahl von Puffern, die für die Sitzung reserviert werden. Der Standardwert ist 0. |
| sidType | Bestimmt, ob bei jedem in den Kanal geschriebenen Ereignis eine Sicherheits-ID (SID) des Prinzipals enthalten sein soll. Legen Sie dieses Attribut auf "Publishing" fest, um die SID in das Ereignis ein schließen zu können. Die SID wird basierend auf der Threadidentität zum Zeitpunkt des Schreibens des Ereignisses festgelegt. Wenn Sie die SID nicht in das Ereignis einindnen möchten, legen Sie dieses Attribut auf "None" fest. Der Standardwert ist "Publishing". |
Hinweise
Sie können diese Veröffentlichungsinformationen für Analyse- und Debugkanaltypen oder für jeden Kanal angeben, der benutzerdefinierte Isolation angibt.
Obwohl Sie Ebene und Schlüsselwörter angeben können, sollten Sie bedenken, dass es sich dabei um die einzigen Ereignisse handelt, die Sie vom Anbieter für diesen Kanal erhalten.
Wenn ein Puffer voll ist, leert ETW den Puffer in die Protokolldatei. Wenn die Puffer schneller gefüllt werden, als sie geleert werden können, werden neue Puffer zugeordnet und dem Pufferpool der Sitzung bis zur angegebenen maximalen Anzahl hinzugefügt. Über diesen Grenzwert hinaus verwirft die Sitzung eingehende Ereignisse, bis ein Puffer verfügbar wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |