Partilhar via

EventCollector

  • Artigo

Representa um coletor de eventos para o perfil.

Hierarquia de elementos

Syntax

<EventCollector Id             = IdType
                Base           = string
                Name           = string
                FileName       = string
                Realtime       = boolean
                Private        = boolean
                ProcessPrivate = boolean
                Secure         = boolean>

  <!-- Child elements -->
  BufferSize,
  Buffers,
  StackCaching,
  MaximumFileSize,
  FileMax,
  FlushTimer,
  FlushThreshold
</EventCollector>

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Padrão
Id Identifica exclusivamente o coletor de eventos. Cadeia de caracteres que deve ter pelo menos um caractere e não pode conter dois-pontos (:) ou espaços. Sim
Base Identifica a base do coletor de eventos. string Não
Nome Indica o nome da sessão ETW. string Sim
FileName Indica o arquivo para o qual registrar eventos em log. string Sim
Realtime Indica se o coletor de eventos opera em tempo real. booleano Não false
Privada Se definido como "true", indica uma sessão de modo de usuário que é executada no mesmo processo que seu provedor de eventos. Se definido como "false", indica uma sessão global do modo de usuário. booleano Não false
ProcessPrivate Se definido como "true", indica uma sessão de modo de usuário que é executada no mesmo processo que seu provedor de eventos e deve ser controlada apenas pelo processo que registrou o provedor. Se definido como "false", indica uma sessão global do modo de usuário. Use esse atributo em conjunto com o atributo Private . booleano Não false
Proteger Se definido como "true", indica que somente usuários com privilégios administrativos e direitos de acesso adequados podem controlar a sessão. Se definido como "false", indica que todos os usuários podem controlar a sessão. booleano Não false

Elementos filho

Elemento Descrição Requisito Padrão
BufferSize Descreve o tamanho de cada buffer, em KB. Opcional, 1. 128
Buffers Descreve o número de buffers a serem alocados ao iniciar uma sessão. Opcional, 1. 64
StackCaching Descreve os atributos de cache de pilha de coletores. Opcional, 1.
MaximumFileSize Descreve o tamanho máximo do arquivo de rastreamento. Opcional, 1.
FileMax Descreve o número máximo de instâncias do arquivo de log que o ETW cria para o rastreamento do Autologger. Opcional, 1.

Elementos pai

Elemento Descrição
Perfis Representa uma coleção de coletores, provedores e perfis.

Comentários

As definições do coletor do sistema devem preceder as definições do coletor de eventos.

Os coletores derivados herdam todos os atributos do coletor base, a menos que sejam especificados explicitamente no coletor derivado. Para obter mais informações, consulte Herança.

Exemplo

O exemplo de código a seguir define um coletor de eventos com 64 buffers de 128 KB cada.

<EventCollector
  Id="WPREventCollector"
  Name="WPR Event Collector"
  FileName="somefilename.etl"> 
  <BufferSize
    Value="128"/> 
  <Buffers
    Value="64"/>
</EventCollector>

Elementos