EventNameFilters

O elemento EventNameFilters inclui ou exclui eventos de log de rastreamento com base em seus nomes.

Observação

Disponível em Windows 10, versão 1709 e posterior.

Hierarquia de elementos

• < WindowsPerformanceRecorder>
  • < Perfis>
    • < Eventprovider>
      • < EventNameFilters>
    • < Perfil>
      • < Colecionadores>
        • < EventCollectorId>
          • < EventProviders>
            • < Eventprovider>
              • < EventNameFilters>

Syntax

<EventNameFilters FilterIn="true|false" Level="unsigned byte" Operation ="Set|Add|Remove" >

  <!-- Child elements -->
  <Keyword>
  <EventName>

</EventNameFilters>

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dados	Obrigatório	Padrão
FilterIn	Indica se os eventos de stackwalk especificados devem ser incluídos ou excluídos.	booleano	Sim
Level	nível de evento	Bytes não assinados	Não
Operação	Indica se as palavras-chave devem ser definidas ou adicionadas.	Esse atributo pode ter um dos seguintes valores: Definir Adicionar Remover	Não	Definir

Elementos filho

Elemento	Descrição	Requisito
EventName	Um nome de evento de log de rastreamento.	Obrigatório, 1 ou mais.
Palavra-chave	Palavra-chave de eventos	Opcional

Elementos pai

Elemento	Descrição
Eventprovider	Representa um provedor de eventos para o perfil.

Comentário

O elemento EventNameFilters habilita a filtragem de eventos por meio de EVENT_FILTER_DESCRIPTOR, Type EVENT_FILTER_TYPE_EVENT_NAME.

Embora o ETW dê suporte a conteúdo avançado e filtragem de atributos, os eventos devem ser filtrados principalmente com base em filtros de escopo ou por meio de nível e palavra-chave para menos sobrecarga de CPU.

Exemplo

    <EventProvider Id="EventProvider_TraceLogGen" Name="3970F9cf-2c0c-4f11-b1cc-e3a1e9958833">
      <EventNameFilters FilterIn="true" Level="5">
        <Keyword Value="0x10000000000000"/>
        <EventName Value="Preset1"/>
        <EventName Value="Preset2"/>
      </EventNameFilters>
    </EventProvider>

Tópicos relacionados

Elementos