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