Partager via


Type complexe ChannelType

Définit un canal sur lequel les fournisseurs peuvent journaliser les événements.

<xs:complexType name="ChannelType"
    mixed="true"
>
    <xs:sequence>
        <xs:element name="logging"
            type="ChannelLoggingType"
            minOccurs="0"
         />
        <xs:element name="publishing"
            type="ChannelPublishingType"
            minOccurs="0"
         />
    </xs:sequence>
    <xs:attribute name="name"
        type="anyURI"
        use="required"
     />
    <xs:attribute name="chid"
        type="token"
        use="optional"
     />
    <xs:attribute name="type"
        type="string"
        use="required"
     />
    <xs:attribute name="symbol"
        type="CSymbolType"
        use="optional"
     />
    <xs:attribute name="access"
        type="string"
        use="optional"
     />
    <xs:attribute name="isolation"
        type="string"
        use="optional"
     />
    <xs:attribute name="enabled"
        type="boolean"
        default="false"
        use="optional"
     />
    <xs:attribute name="value"
        type="UInt8Type"
        use="optional"
     />
    <xs:attribute name="message"
        type="string"
        use="optional"
     />
</xs:complexType>

Éléments enfants

Élément Type Description
Enregistrement ChannelLoggingType Définit les propriétés du fichier journal qui sauvegarde le canal, telles que sa capacité et si le fichier journal est séquentiel ou circulaire.
Édition ChannelPublishingType Définit les propriétés de journalisation de la session que le canal utilise. Seuls les canaux de débogage et d’analytique et les canaux qui utilisent l’isolation personnalisée peuvent spécifier des propriétés de journalisation pour leur session.

Attributs

Nom Type Description
access string Un descripteur d’accès SDDL ( Security Descriptor Definition Language ) qui contrôle l’accès au fichier journal qui sauvegarde le canal. Si l’attribut d’isolation est défini sur Application ou Système, le descripteur d’accès contrôle l’accès en lecture au fichier (les autorisations d’écriture sont ignorées). Si l’attribut d’isolation est défini sur Personnalisé, le descripteur d’accès contrôle l’accès en écriture au canal et l’accès en lecture au fichier.
chid token Identificateur qui identifie de manière unique le canal dans la liste des canaux que le fournisseur définit ou importe. Utilisez cette valeur lors du référencement du canal dans un événement. Si vous ne spécifiez pas d’identificateur de canal, utilisez le nom du canal pour référencer ce canal dans une définition d’événement.
enabled boolean Détermine si le canal est activé. Définissez sur true pour autoriser la journalisation dans le canal ; sinon, false. La valeur par défaut est false (la journalisation est désactivée).
Étant donné que les types de canaux Debug et Analytics sont des canaux à volume élevé, vous devez activer le canal uniquement lors de l’examen d’un problème avec un composant qui écrit dans ce canal ; sinon, le canal doit rester désactivé.
Chaque fois que vous activez un canal Debug et Analytics, le service efface les événements du canal.
isolation string La valeur d’isolation définit les autorisations d’accès par défaut pour le canal. Vous pouvez spécifier l'une des valeurs suivantes :
  • Application
  • Système
  • Personnalisée
L’isolation par défaut est Application. Les autorisations par défaut pour Application sont (affichées à l’aide de SDDL) :
Texte
            L"O:BAG:SYD:"
            L"(A;;0xf0007;;;SY)"                // local system               (read, write, clear)
            L"(A;;0x7;;;BA)"                    // built-in admins            (read, write, clear)
            L"(A;;0x7;;;SO)"                    // server operators           (read, write, clear)
            L"(A;;0x3;;;IU)"                    // INTERACTIVE LOGON          (read, write)
            L"(A;;0x3;;;SU)"                    // SERVICES LOGON             (read, write)
            L"(A;;0x3;;;S-1-5-3)"               // BATCH LOGON                (read, write)
            L"(A;;0x3;;;S-1-5-33)"              // write restricted service   (read, write)
            L"(A;;0x1;;;S-1-5-32-573)";         // event log readers          (read) 

Les autorisations par défaut pour System sont (affichées à l’aide de SDDL) :

Texte
            L"O:BAG:SYD:"
            L"(A;;0xf0007;;;SY)"                // local system             (read, write, clear)
            L"(A;;0x7;;;BA)"                    // built-in admins          (read, write, clear)
            L"(A;;0x3;;;BO)"                    // backup operators         (read, write)
            L"(A;;0x5;;;SO)"                    // server operators         (read, clear) 
            L"(A;;0x1;;;IU)"                    // INTERACTIVE LOGON        (read)
            L"(A;;0x3;;;SU)"                    // SERVICES LOGON           (read, write)
            L"(A;;0x1;;;S-1-5-3)"               // BATCH LOGON              (read)
            L"(A;;0x2;;;S-1-5-33)"              // write restricted service (write)
            L"(A;;0x1;;;S-1-5-32-573)";         // event log readers        (read)

Les autorisations par défaut pour l’isolation personnalisée sont les mêmes que celles de l’application.

Les canaux qui spécifient l’isolation d’application utilisent la même session ETW. Il en va de même pour l’isolation du système . Toutefois, si vous spécifiez Isolation personnalisée , le service crée une session ETW distincte pour le canal. L’utilisation de l’isolation personnalisée vous permet de contrôler les autorisations d’accès pour le canal et le fichier de stockage. Étant donné qu’il n’y a que 64 sessions ETW disponibles, vous devez limiter votre utilisation de l’isolation personnalisée .

message string

Nom complet localisé pour le canal. La chaîne de message fait référence à une chaîne localisée dans la section stringTable du manifeste.

name anyURI

Nom du canal. Le nom doit être unique dans la liste des canaux que le fournisseur utilise. La convention pour nommer des canaux consiste à ajouter le type de canal au nom du fournisseur. Par exemple, si le nom du fournisseur est Company-Product-Component et que vous définissez un canal opérationnel, le nom est Company-Product-Component/Operational.

Les noms de canal doivent comporter moins de 255 caractères et ne peuvent pas contenir les caractères suivants : « > », « < », « & », « » « », « \ », « : », « » « ? », « * » ou des caractères dont les codes sont inférieurs à 31.

symbole CSymbolType

Symbole à utiliser pour référencer le canal dans votre application. Le compilateur de messages (MC.exe) utilise le symbole pour créer une constante pour le canal dans le fichier d’en-tête généré par le compilateur. Si vous ne spécifiez pas de symbole, le compilateur génère le nom pour vous.

type string

Identifie le type du canal. Vous pouvez spécifier l’un des types suivants :

  • Administrateur
  • En fonctionnement
  • Analytiques
  • Déboguer

Administration types de canaux prennent en charge les événements qui ciblent les utilisateurs finaux, les administrateurs et le personnel de support. Les événements écrits dans les canaux Administration doivent avoir une solution bien définie sur laquelle l’administrateur peut agir. Un exemple d’événement administrateur est un événement qui se produit lorsqu’une application ne parvient pas à se connecter à une imprimante. Ces événements sont bien documentés ou associés à un message qui donne au lecteur des instructions directes sur ce qui doit être fait pour corriger le problème.

Les canaux de type opérationnel prennent en charge les événements utilisés pour analyser et diagnostiquer un problème ou une occurrence. Ils peuvent être utilisés pour déclencher des outils ou des tâches selon le problème ou l'occurrence. Un exemple d'événement opérationnel est un événement qui se produit lorsqu'une imprimante est ajoutée ou supprimée d'un système.

Les canaux de type analytique prennent en charge les événements publiés dans un volume élevé. Ils décrivent une opération de programme et indiquent des problèmes qui ne peuvent pas être pris en charge par une intervention de l'utilisateur.

Les canaux de type de débogage prennent en charge les événements qui sont utilisés uniquement par les développeurs pour diagnostiquer un problème de débogage.

Les canaux d’analyse et de débogage sont désactivés par défaut et doivent uniquement être activés pour déterminer la cause d’un problème. Par exemple, vous activez le canal, exécutez le scénario à l’origine du problème, désactivez le canal, puis interrogez les événements. Notez que l’activation du canal efface le canal des événements existants. Si le canal analytique et de débogage utilise un fichier de stockage circulaire, vous devez désactiver le canal pour interroger ses événements.

Tous les canaux Administration utilisent la même session ETW ; il en va de même pour les canaux opérationnels. Toutefois, chaque canal d’analyse et de débogage utilise une session ETW distincte, ce qui est une autre raison d’activer ces types de canaux uniquement si nécessaire (un nombre limité de sessions ETW est disponible).

value UInt8Type

Identificateur numérique qui identifie de manière unique le canal dans la liste des canaux que le fournisseur définit. Le compilateur de messages affecte la valeur si elle n’est pas spécifiée.

Notes

Si le nom du canal suit la convention de nommage de canal, le observateur d'événements Windows répertorie le canal à l’aide de la chaîne qui suit la barre oblique inverse. Par exemple, si le nom du canal est Company-Product-Component/Operational, le observateur d'événements répertorie le canal comme opérationnel sous le fournisseur Entreprise-Produit-Composant. Sinon, le nom du canal entier s’affiche sous le fournisseur. Le nom d’affichage localisé est utilisé s’il est fourni.

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]

`