Freigeben über


ChannelPublishingType Complex Type

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 Typ BESCHREIBUNG
Buffersize UInt32Type Die Menge des Arbeitsspeichers in KB, die für jeden Puffer zugeordnet werden soll. Wenn Sie eine relativ niedrige Ereignisrate erwarten, sollte die Puffergröße auf die Größe der Speicherseite festgelegt werden. Wenn die Ereignisrate voraussichtlich relativ hoch ist, 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 gefüllt und geleert werden müssen. Obwohl eine kleine Puffergröße weniger Arbeitsspeicher benötigt, 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 Betriebsbereit 64 KB.
clockType Die Zeitauflösung, die beim Protokollieren des Zeitstempels für jedes Ereignis verwendet werden soll. Sie können SystemTime oder QPC angeben. SystemTime stellt einen Zeitstempel mit niedriger Auflösung (10 Millisekunden) bereit, ist aber vergleichsweise kostengünstiger abzurufen. Der Standardwert ist SystemTime.
Der Abfrageleistungsindikator (Query Performance Counter, QPC) stellt einen hochauflösenden Zeitstempel (100 Nanosekunden) bereit, ist aber vergleichsweise teurer abzurufen. Sie sollten QPC verwenden, wenn Sie hohe Ereignisraten haben oder wenn der Consumer Ereignisse aus verschiedenen Puffern zusammenführt.
controlGuid GUIDType Gibt die Sitzungs-GUID für eine ETW-Sitzung an, 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 (0x0000000000000000) festgelegt sind. Sie müssen mit Schlüsselwörtern aktiviert werden, die auf 0xffffffffffffffff festgelegt sind.
fileMax UInt32Type Die maximale Anzahl von Fällen, 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 gehen verloren. Wenn der Wert größer als 1 ist, erstellt der Dienst bei jeder Aktivierung des Kanals eine neue Protokolldatei, um die Ereignisse beizubehalten. Der Standardwert ist 1, und das Maximum, das Sie angeben können, ist 16.
Der Dienst fügt jedem Dateinamen eine dreistellige Dezimalzahl zwischen 0 und fileMax 1 an. Beispiel : filename.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 in den Kanal geschrieben, die eine Schlüsselwort (keyword) definiert haben, die in der Bitmaske der Schlüsselwörter enthalten ist. Die Standardeinstellung ist 0.
Debugkanäle, für die das controlGuid-Attribut festgelegt ist, müssen das Keywords-Attribut auf 0xFFFFFFFFFFFFFFFF festlegen.
Die Sitzung übergibt den Schlüsselwortwert an den Anbieter, wenn der Anbieter aktiviert wird.
Latenz UInt32Type Die Wartezeit vor dem Leeren der Puffer in Millisekunden. Bei Null leert ETW die Puffer, sobald sie voll werden. Wenn nicht zero, leert ETW alle Puffer, die Ereignisse basierend auf dem Wert enthalten, auch wenn der Puffer nicht voll ist. In der Regel möchten Sie Puffer nur leeren, wenn sie voll sind. Das Erzwingen der Puffer zum Leeren kann die Dateigröße der Protokolldatei mit nicht ausgefülltem Pufferspeicher erhöhen. Der Standardwert ist 1 Sekunde für Admin- und Betriebsprotokolle und 5 Sekunden für Analyse- und Debugprotokolle.
Ebene UInt8Type Der Schweregrad der Ereignisse, die in den Kanal geschrieben werden sollen. Der Dienst schreibt Ereignisse in den Kanal, die über einen Ebenenwert verfügen, der kleiner oder gleich dem angegebenen Wert ist. Der Standardwert ist 0. Dies bedeutet, dass Ereignisse mit einem beliebigen Ebenenwert protokolliert werden.
Die Sitzung übergibt den Levelwert an den Anbieter, wenn der Anbieter aktiviert wird.
maxBuffers UInt32Type Die maximale Anzahl von Puffern, die für die Sitzung zugewiesen werden sollen. In der Regel ist dieser Wert die Mindestanzahl von Puffern plus zwanzig. Dieser Wert muss größer oder gleich dem für minBuffers angegebenen Wert sein.
Die standardmäßige maximale Anzahl von Puffern für Analyse- und Debugkanäle beträgt 10 KB und für Admin und Betrieb 64 KB.
minBuffers UInt32Type Die Mindestanzahl von Puffern, die für die Sitzung zugewiesen werden sollen. Der Standardwert ist 0.
sidType Bestimmt, ob mit jedem in den Kanal geschriebenen Ereignis eine Sicherheits-ID (SID) des Prinzipals eingeschlossen werden soll. Wenn Sie die SID in das Ereignis einschließen möchten, legen Sie dieses Attribut auf "Publishing" fest. Die SID wird basierend auf der Threadidentität zum Zeitpunkt des Schreibens des Ereignisses festgelegt. Wenn Sie die SID nicht in das Ereignis einschließen möchten, legen Sie dieses Attribut auf "None" fest. Der Standardwert ist "Veröffentlichung".

Bemerkungen

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 berücksichtigen, dass dies die einzigen Ereignisse sind, die Sie vom Anbieter für diesen Kanal erhalten.

Wenn ein Puffer voll ist, löscht 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 ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2008 [nur Desktop-Apps]