Compartilhar via


Tipo complexo ChannelType

Define um canal para o qual os provedores podem registrar eventos.

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

Elementos filho

Elemento Type Descrição
Log ChannelLoggingType Define as propriedades do arquivo de log que faz backup do canal, como sua capacidade e se o arquivo de log é sequencial ou circular.
Publicação ChannelPublishingType Define as propriedades de registro em log para a sessão que o canal usa. Somente canais e canais de Depuração e Análise que usam isolamento personalizado podem especificar propriedades de log para sua sessão.

Atributos

Nome Type Descrição
access string Um descritor de acesso SDDL ( Security Descriptor Definition Language ) que controla o acesso ao arquivo de log que faz backup do canal. Se o atributo de isolamento estiver definido como Aplicativo ou Sistema, o descritor de acesso controlará o acesso de leitura ao arquivo (as permissões de gravação serão ignoradas). Se o atributo de isolamento estiver definido como Personalizado, o descritor de acesso controlará o acesso de gravação ao canal e o acesso de leitura ao arquivo.
chid token Um identificador que identifica exclusivamente o canal na lista de canais que o provedor define ou importa. Use esse valor ao referenciar o canal em um evento. Se você não especificar um identificador de canal, use o nome do canal para referenciar esse canal em uma definição de evento.
Habilitado booleano Determina se o canal está habilitado. Defina como true para permitir o registro em log no canal; caso contrário, false. O padrão é false (o registro em log está desabilitado).
Como os tipos de canal de Depuração e Análise são canais de alto volume, você deve habilitar o canal somente ao investigar um problema com um componente que grava nesse canal; caso contrário, o canal deverá permanecer desabilitado.
Sempre que você habilita um canal de Depuração e Análise, o serviço limpa os eventos do canal.
isolamento string O valor de isolamento define as permissões de acesso padrão para o canal. É possível especificar um dos seguintes valores:
  • Aplicativo
  • System
  • Personalizado
O isolamento padrão é Application. As permissões padrão para o Aplicativo são (mostradas usando SDDL):
Texto
            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) 

As permissões padrão para System são (mostradas usando SDDL):

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

As permissões padrão para Isolamento personalizado são as mesmas do Aplicativo.

Os canais que especificam o isolamento do aplicativo usam a mesma sessão ETW. O mesmo vale para o isolamento do sistema . No entanto, se você especificar Isolamento personalizado , o serviço criará uma sessão ETW separada para o canal. O uso do isolamento personalizado permite controlar as permissões de acesso para o canal e o arquivo de backup. Como há apenas 64 sessões ETW disponíveis, você deve limitar o uso de Isolamento personalizado .

message string

O nome de exibição localizado para o canal. A cadeia de caracteres de mensagem faz referência a uma cadeia de caracteres localizada na seção stringTable do manifesto.

name anyURI

O nome do canal. O nome deve ser exclusivo na lista de canais que o provedor usa. A convenção para nomenclatura de canais é acrescentar o tipo de canal ao nome do provedor. Por exemplo. se o nome do provedor for Company-Product-Component e você estiver definindo um canal operacional, o nome será Company-Product-Component/Operational.

Os nomes de canal devem ter menos de 255 caracteres e não podem conter os seguintes caracteres: '>', '<', '&', '"', '|', '\', ':', '', '?', '*' ou caracteres com códigos menores que 31.

símbolo CSymbolType

O símbolo a ser usado para fazer referência ao canal em seu aplicativo. O Compilador de Mensagens (MC.exe) usa o símbolo para criar uma constante para o canal no arquivo de cabeçalho gerado pelo compilador. Se você não especificar um símbolo, o compilador gerará o nome para você.

tipo string

Identifica o tipo do canal. Você pode especificar um dos seguintes tipos:

  • Administrador
  • Operacional
  • Analítico
  • Depurar

Administração canais de tipo dão suporte a eventos direcionados a usuários finais, administradores e pessoal de suporte. Os eventos gravados nos canais de Administração devem ter uma solução bem definida na qual o administrador pode agir. Um exemplo de um evento de administrador é um evento que ocorre quando um aplicativo falha ao se conectar a uma impressora. Esses eventos são bem documentados ou têm uma mensagem associada a eles que fornece ao leitor instruções diretas sobre o que deve ser feito para corrigir o problema.

Os canais de tipo operacional dão suporte a eventos que são usados para analisar e diagnosticar um problema ou ocorrência. Eles podem ser usados para disparar ferramentas ou tarefas com base no problema ou na ocorrência. Um exemplo de evento operacional é um evento que ocorre quando uma impressora é adicionada ou removida de um sistema.

Os canais de tipo analítico dão suporte a eventos publicados em alto volume. Eles descrevem a operação do programa e indicam os problemas que não podem ser tratados por intervenção do usuário.

Os canais de tipo de depuração dão suporte a eventos que são usados exclusivamente por desenvolvedores para diagnosticar um problema de depuração.

Os canais analíticos e de depuração são desabilitados por padrão e só devem ser habilitados para determinar a causa de um problema. Por exemplo, você habilitaria o canal, executaria o cenário que está causando o problema, desabilitaria o canal e, em seguida, consultaria os eventos. Observe que habilitar o canal limpa o canal de eventos existentes. Se o canal analítico e de depuração usar um arquivo de suporte circular, você deverá desabilitar o canal para consultar seus eventos.

Todos os canais Administração usam a mesma sessão ETW; o mesmo vale para canais operacionais. No entanto, cada canal analítico e de depuração usa uma sessão ETW separada, o que é outro motivo para habilitar esses tipos de canal somente quando necessário (há um número limitado de sessões ETW disponíveis).

value UInt8Type

Um identificador numérico que identifica exclusivamente o canal dentro da lista de canais que o provedor define. O compilador de mensagem atribuirá o valor se não for especificado.

Comentários

Se o nome do canal seguir a convenção de nomenclatura do canal, o Visualizador de Eventos do Windows listará o canal usando a cadeia de caracteres que segue a barra invertida. Por exemplo, se o nome do canal for Company-Product-Component/Operational, o Visualizador de Eventos listará o canal como Operacional no provedor Company-Product-Component. Caso contrário, todo o nome do canal será mostrado no provedor. O nome de exibição localizado será usado se for fornecido.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 [somente aplicativos da área de trabalho]

`