Type complexe ChannelPublishingType

Définit les propriétés de journalisation de la session que le canal utilise.

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

Éléments enfants

Élément	Type	Description
bufferSize	UInt32Type	Quantité de mémoire, en kilo-octets, à allouer pour chaque mémoire tampon. Si vous vous attendez à un taux d’événements relativement faible, la taille de la mémoire tampon doit être définie sur la taille de la page mémoire. Si le taux d’événements est censé être relativement élevé, vous devez spécifier une plus grande taille de mémoire tampon et augmenter le nombre maximal de mémoires tampons. La taille de la mémoire tampon affecte la vitesse à laquelle les mémoires tampons se remplissent et doivent être vidées. Bien qu’une petite taille de mémoire tampon nécessite moins de mémoire, elle augmente la vitesse à laquelle les mémoires tampons doivent être vidées. La taille de la mémoire tampon par défaut pour les canaux d’analyse et de débogage est de 4 Ko, et de 64 Ko pour Administration et Opérationnel.
clockType		Résolution d’horloge à utiliser lors de la journalisation de l’horodatage pour chaque événement. Vous pouvez spécifier SystemTime ou QPC. SystemTime fournit un horodatage à faible résolution (10 millisecondes), mais il est comparativement moins coûteux à récupérer. La valeur par défaut est SystemTime. Le compteur de performances des requêtes (QPC) fournit un horodatage haute résolution (100 nanosecondes), mais il est comparativement plus coûteux à récupérer. Vous devez QPC si vous avez des taux d’événements élevés ou si le consommateur fusionne des événements à partir de différentes mémoires tampons.
controlGuid	GUIDType	Identifie le GUID de session pour une session ETW qui contient des événements WPP. Ce paramètre est autorisé uniquement pour les canaux de type Debug. Ces canaux ne peuvent pas être entièrement activés avec des mots clés définis sur zéro (0x0000000000000000). Ils doivent être activés avec des mots clés définis sur 0xffffffffffffffff.
fileMax	UInt32Type	Nombre maximal de fois où vous souhaitez que le service crée un fichier journal lorsque le canal est activé (y compris lorsque l’ordinateur est redémarré). Si la valeur est 0 ou 1, le service remplace le fichier journal chaque fois que le canal est activé et les événements précédents sont perdus. Si la valeur est supérieure à 1, le service crée un fichier journal chaque fois que le canal est activé afin de conserver les événements. La valeur par défaut est 1 et la valeur maximale que vous pouvez spécifier est 16. Le service ajoute un nombre décimal à trois chiffres compris entre 0 et fileMax 1 à chaque nom de fichier. Par exemple, filename.etl.xxx, où xxx est le nombre décimal à trois chiffres. Les fichiers se trouvent dans %windir%\System32\winevt\Logs.
Mots-clés	UInt64Type	Masque de bits qui détermine la catégorie d’événements écrits dans le canal. Si la valeur de l’attribut keywords est 0, tous les événements écrits par le fournisseur sont écrits dans le canal ; sinon, seuls les événements qui ont défini un mot clé inclus dans le masque de bits de mots clés sont écrits dans le canal. La valeur par défaut est 0. Les canaux de débogage qui ont l’attribut controlGuid défini doivent définir l’attribut keywords sur 0xFFFFFFFFFFFFFFFF. La session transmet la valeur des mots clés au fournisseur lorsqu’il active le fournisseur.
Latence	UInt32Type	Temps d’attente avant de vider les mémoires tampons, en millisecondes. Si la valeur est zéro, ETW vide les mémoires tampons dès qu’elles sont saturées. Si elle n’est pas nulle, ETW vide toutes les mémoires tampons qui contiennent des événements en fonction de la valeur, même si la mémoire tampon n’est pas pleine. En règle générale, vous ne souhaitez vider les mémoires tampons que lorsqu’elles deviennent saturées. Forcer le vidage des mémoires tampons peut augmenter la taille du fichier journal avec un espace tampon non rempli. La valeur par défaut est 1 seconde pour les journaux Administration et opérationnels et 5 secondes pour les journaux d’analyse et de débogage.
Niveau	UInt8Type	Niveau de gravité des événements à écrire dans le canal. Le service écrit des événements dans le canal qui ont une valeur de niveau inférieure ou égale à la valeur spécifiée. La valeur par défaut est 0, ce qui signifie journaliser les événements avec n’importe quelle valeur de niveau. La session transmet la valeur de niveau au fournisseur lorsqu’il active le fournisseur.
maxBuffers	UInt32Type	Nombre maximal de mémoires tampons à allouer pour la session. En règle générale, cette valeur est le nombre minimal de mémoires tampons plus vingt. Cette valeur doit être supérieure ou égale à la valeur spécifiée pour minBuffers. Le nombre maximal de mémoires tampons par défaut pour les canaux d’analyse et de débogage est de 10 Ko, et pour Administration et Opérationnel, il est de 64 Ko.
minBuffers	UInt32Type	Nombre minimal de mémoires tampons à allouer pour la session. La valeur par défaut est zéro.
sidType		Détermine s’il faut inclure un identificateur de sécurité (SID) du principal avec chaque événement écrit dans le canal. Pour inclure le SID avec l’événement, définissez cet attribut sur « Publication ». Le SID est défini en fonction de l’identité du thread au moment où l’événement est écrit. Si vous ne souhaitez pas inclure le SID avec l’événement, définissez cet attribut sur « None ». La valeur par défaut est « Publication ».

Notes

Vous pouvez spécifier ces informations de publication pour les types de canaux d’analyse et de débogage ou pour tout canal qui spécifie l’isolation personnalisée.

Bien que vous puissiez spécifier le niveau et les mots clés, vous devez considérer qu’il s’agit des seuls événements que vous recevrez du fournisseur pour ce canal.

Lorsqu’une mémoire tampon est pleine, ETW vide la mémoire tampon dans le fichier journal. Si les mémoires tampons sont remplies plus rapidement qu’elles ne peuvent être vidées, de nouvelles mémoires tampons sont allouées et ajoutées au pool de mémoires tampons de la session, jusqu’au nombre maximal spécifié. Au-delà de cette limite, la session ignore les événements entrants jusqu’à ce qu’une mémoire tampon soit disponible.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]