Compartilhar via

Tipo complexo ChannelPublishingType

  • Artigo

Define as propriedades de registro em log para a sessão que o canal usa.

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

Elementos filho

Elemento Type Descrição
Buffersize UInt32Type A quantidade de memória, em quilobytes, a ser alocada para cada buffer. Se você espera uma taxa de eventos relativamente baixa, o tamanho do buffer deve ser definido como o tamanho da página de memória. Se a taxa de eventos for relativamente alta, você deverá especificar um tamanho de buffer maior e aumentar o número máximo de buffers.
O tamanho do buffer afeta a taxa na qual os buffers são preenchidos e devem ser liberados. Embora um tamanho de buffer pequeno exija menos memória, ele aumenta a taxa na qual os buffers devem ser liberados.
O tamanho do buffer padrão para canais analíticos e de depuração é de 4 KB e, para Administração e Operacional, é de 64 KB.
clockType A resolução do relógio a ser usada ao registrar o carimbo de data/hora para cada evento. Você pode especificar SystemTime ou QPC. SystemTime fornece um carimbo de data/hora de baixa resolução (10 milissegundos), mas é relativamente menos caro de recuperar. O padrão é SystemTime.
O QPC (contador de desempenho de consulta) fornece um carimbo de data/hora de alta resolução (100 nanossegundos), mas é relativamente mais caro de recuperar. Você deverá ter QPC se tiver altas taxas de eventos ou se o consumidor mesclar eventos de buffers diferentes.
controlGuid GUIDType Identifica o GUID da sessão para uma sessão ETW que contém eventos WPP. Essa configuração só é permitida para canais do tipo Depurar. Esses canais não podem ser totalmente habilitados com palavras-chave definidas como zero (0x0000000000000000). Eles devem ser habilitados com palavras-chave definidas como 0xffffffffffffffff.
fileMax UInt32Type O número máximo de vezes que você deseja que o serviço crie um novo arquivo de log quando o canal está habilitado (inclui quando o computador é reiniciado). Se o valor for 0 ou 1, o serviço substituirá o arquivo de log sempre que o canal estiver habilitado e os eventos anteriores forem perdidos. Se o valor for maior que 1, o serviço criará um novo arquivo de log sempre que o canal estiver habilitado para preservar os eventos. O padrão é 1 e o máximo que você pode especificar é 16.
O serviço acrescenta um número decimal de três dígitos entre 0 e fileMax 1 a cada nome de arquivo. Por exemplo, filename.etl.xxx, em que xxx é o número decimal de três dígitos. Os arquivos estão localizados em %windir%\System32\winevt\Logs.
Keywords UInt64Type Uma máscara de bits que determina a categoria de eventos que são gravados no canal. Se o valor do atributo de palavras-chave for 0, todos os eventos gravados pelo provedor serão gravados no canal; caso contrário, somente os eventos que definiram um palavra-chave incluído na máscara de bits de palavras-chave serão gravados no canal. O padrão é 0.
Os canais de depuração que têm o atributo controlGuid definido devem definir o atributo de palavras-chave como 0xFFFFFFFFFFFFFFFF.
A sessão passa o valor de palavras-chave para o provedor quando habilita o provedor.
Latência UInt32Type O tempo de espera antes de liberar os buffers, em milissegundos. Se zero, o ETW libera os buffers assim que eles ficam cheios. Se diferente de zero, o ETW libera todos os buffers que contêm eventos com base no valor, mesmo que o buffer não esteja cheio. Normalmente, você deseja liberar buffers somente quando eles ficam cheios. Forçar a liberação dos buffers pode aumentar o tamanho do arquivo de log com espaço de buffer não preenchido. O valor padrão é 1 segundo para Administração e logs operacionais e 5 segundos para logs analíticos e de depuração.
Nível UInt8Type O nível de gravidade dos eventos a serem gravados no canal. O serviço grava eventos no canal que têm um valor de nível menor ou igual ao valor especificado. O padrão é 0, o que significa registrar eventos com qualquer valor de nível.
A sessão passa o valor de nível para o provedor quando habilita o provedor.
maxBuffers UInt32Type O número máximo de buffers a serem alocados para a sessão. Normalmente, esse valor é o número mínimo de buffers mais vinte. Esse valor deve ser maior ou igual ao valor especificado para minBuffers.
O número máximo padrão de buffers para canais analíticos e de depuração é de 10 KB e para Administração e Operacional é de 64 KB.
minBuffers UInt32Type O número mínimo de buffers a serem alocados para a sessão. O padrão é zero.
sidType Determina se um SID (identificador de segurança) da entidade de segurança deve ser incluído em cada evento gravado no canal. Para incluir o SID com o evento , defina esse atributo como "Publicação". O SID é definido com base na identidade do thread no momento em que o evento é gravado. Se você não quiser incluir o SID com o evento , defina esse atributo como "Nenhum". O padrão é "Publicando".

Comentários

Você pode especificar essas informações de publicação para tipos de canal analítico e de depuração ou para qualquer canal que especifique Isolamento personalizado.

Embora você possa especificar palavras-chave e nível, considere que esses serão os únicos eventos que você receberá do provedor para esse canal.

Quando um buffer está cheio, o ETW libera o buffer para o arquivo de log. Se os buffers forem preenchidos mais rapidamente do que podem ser liberados, novos buffers serão alocados e adicionados ao pool de buffers da sessão, até o número máximo especificado. Além desse limite, a sessão descarta eventos de entrada até que um buffer fique disponível.

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]