Compartilhar via


StackEventNameFilters

O elemento StackEventNameFilters especifica nomes de eventos para incluir ou excluir eventos stackwalk de um provedor de log de rastreamento.

Observação

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

Hierarquia de elementos

Syntax

<StackEventNameFilters FilterIn = "true|false" Operation = "Set|Add|Remove" >

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

</StackEventNameFilters>

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.

Elementos pai

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

Comentário

Quando o stack walking está habilitado para um provedor, a pilha é capturada para todos os eventos gerados pelo provedor. Na maioria das vezes, o usuário só está interessado na pilha de apenas determinado número de eventos.

Esse elemento permite habilitar ou desabilitar a movimentação de pilha em uma lista de eventos com base em IDs de evento.

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="*TraceLogGen">
      <StackEventNameFilters FilterIn="true" Level="5">
        <Keyword Value="0x10000000000000"/>
        <EventName Value="Preset1"/>
        <EventName Value="Preset2"/>
      </StackEventNameFilters>
    </EventProvider>

Elementos