Tipo complesso ChannelType

Definisce un canale a cui i provider possono registrare gli eventi.

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

Elementi figlio

Elemento Tipo Descrizione
Registrazione ChannelLoggingType Definisce le proprietà del file di log che esegue il backup del canale, ad esempio la capacità e se il file di log è sequenziale o circolare.
Pubblicazione ChannelPublishingType Definisce le proprietà di registrazione per la sessione usata dal canale. Solo i canali e i canali di debug e analitici che usano l'isolamento personalizzato possono specificare le proprietà di registrazione per la sessione.

Attributi

Nome Tipo Descrizione
access string Descrittore di accesso SDDL ( Security Descriptor Definition Language ) che controlla l'accesso al file di log che supporta il canale. Se l'attributo di isolamento è impostato su Application o System, il descrittore di accesso controlla l'accesso in lettura al file (le autorizzazioni di scrittura vengono ignorate). Se l'attributo di isolamento è impostato su Personalizzato, il descrittore di accesso controlla l'accesso in scrittura al canale e l'accesso in lettura al file.
chid token Identificatore che identifica in modo univoco il canale nell'elenco di canali definiti o importati dal provider. Usare questo valore quando si fa riferimento al canale in un evento. Se non si specifica un identificatore di canale, usare il nome del canale per fare riferimento a questo canale in una definizione di evento.
Enabled boolean Determina se il canale è abilitato. Impostare su true per consentire la registrazione al canale; in caso contrario, false. Il valore predefinito è false (la registrazione è disabilitata).
Poiché i tipi di canale debug e analitico sono canali con volumi elevati, è necessario abilitare il canale solo quando si analizza un problema con un componente che scrive in tale canale; in caso contrario, il canale deve rimanere disabilitato.
Ogni volta che si abilita un canale debug e analitico, il servizio cancella gli eventi dal canale.
Isolamento string Il valore di isolamento definisce le autorizzazioni di accesso predefinite per il canale. È possibile specificare uno dei valori seguenti:
  • Applicazione
  • Sistema
  • Impostazione personalizzata
L'isolamento predefinito è Application. Le autorizzazioni predefinite per l'applicazione sono (visualizzate usando SDDL):
Testo
            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) 

Le autorizzazioni predefinite per System sono (visualizzate usando SDDL):

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

Le autorizzazioni predefinite per l'isolamento personalizzato sono uguali a Application.

I canali che specificano l'isolamento dell'applicazione usano la stessa sessione ETW. Lo stesso vale per l'isolamento del sistema . Tuttavia, se si specifica l'isolamento personalizzato , il servizio crea una sessione ETW separata per il canale. L'uso dell'isolamento personalizzato consente di controllare le autorizzazioni di accesso per il canale e il file di backup. Poiché sono disponibili solo 64 sessioni ETW, è consigliabile limitare l'uso dell'isolamento personalizzato .

message string

Nome visualizzato localizzato per il canale. La stringa di messaggio fa riferimento a una stringa localizzata nella sezione stringTable del manifesto.

name anyURI

Nome del canale. Il nome deve essere univoco all'interno dell'elenco di canali utilizzati dal provider. La convenzione per la denominazione dei canali consiste nell'aggiungere il tipo di canale al nome del provider. Ad esempio, se il nome del provider è Company-Product-Component e si sta definendo un canale operativo, il nome sarà Company-Product-Component/Operational.

I nomi dei canali devono essere inferiori a 255 caratteri e non possono contenere i caratteri seguenti: '>', '<', '&', '',', '|', '\', ':', '', '?', '*' o caratteri con codici minori di 31.

simbolo CSymbolType

Simbolo da usare per fare riferimento al canale nell'applicazione. Il compilatore di messaggi (MC.exe) usa il simbolo per creare una costante per il canale nel file di intestazione generato dal compilatore. Se non si specifica un simbolo, il compilatore genera automaticamente il nome.

tipo string

Identifica il tipo del canale. È possibile specificare uno dei tipi seguenti:

  • Admin
  • Operativo
  • Analitici
  • Eseguire il debug

I canali di tipo amministratore supportano gli eventi destinati a utenti finali, amministratori e personale di supporto. Gli eventi scritti nei canali di amministrazione devono avere una soluzione ben definita in cui l'amministratore può agire. Un esempio di evento amministratore è un evento che si verifica quando un'applicazione non riesce a connettersi a una stampante. Questi eventi sono ben documentati o hanno un messaggio associato a essi che fornisce al lettore istruzioni dirette di ciò che deve essere fatto per correggere il problema.

I canali di tipo operativo supportano gli eventi usati per l'analisi e la diagnosi di un problema o di un'occorrenza. Si possono utilizzare per lanciare strumenti o attività basati sul problema o sull'occorrenza. Un esempio di un evento operativo è un evento che si verifica quando si aggiunge o rimuove una stampante da un sistema.

I canali di tipo analitico supportano gli eventi pubblicati in volumi elevati. Essi descrivono le operazioni del programma e indicano problemi che non possono essere gestiti dall'intervento dell'utente.

I canali di tipo di debug supportano gli eventi usati esclusivamente dagli sviluppatori per diagnosticare un problema per il debug.

I canali analitici e di debug sono disabilitati per impostazione predefinita e devono essere abilitati solo per determinare la causa di un problema. Ad esempio, è possibile abilitare il canale, eseguire lo scenario che causa il problema, disabilitare il canale e quindi eseguire una query sugli eventi. Si noti che l'abilitazione del canale cancella il canale degli eventi esistenti. Se il canale analitico e di debug usa un file di backup circolare, è necessario disabilitare il canale per eseguire query sui relativi eventi.

Tutti i canali di amministrazione usano la stessa sessione ETW; lo stesso vale per i canali operativi. Tuttavia, ogni canale analitico e di debug usa una sessione ETW separata, un altro motivo per abilitare questi tipi di canale solo quando necessario (è disponibile un numero limitato di sessioni ETW).

Valore UInt8Type

Identificatore numerico che identifica in modo univoco il canale all'interno dell'elenco di canali definiti dal provider. Se non specificato, il compilatore di messaggi assegna il valore .

Commenti

Se il nome del canale segue la convenzione di denominazione del canale, il Windows Visualizzatore eventi elenca il canale usando la stringa che segue la barra rovesciata. Ad esempio, se il nome del canale è Company-Product-Component/Operational, il Visualizzatore eventi elenca il canale come Operativo nel provider Company-Product-Component. In caso contrario, l'intero nome del canale viene visualizzato nel provider. Se specificato, viene utilizzato il nome visualizzato localizzato.

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2008 [solo app desktop]

`