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:
As permissões padrão para System são (mostradas usando SDDL):
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:
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] |
`