EventCollector

Representa un recopilador de eventos para el perfil.

Jerarquía de elementos

• < WindowsPerformanceRecorder>
  • < Perfiles>
    • < EventCollector>

Sintaxis

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

Atributos

Atributo	Descripción	Tipo de datos	Obligatorio	Valor predeterminado
Id	Identifica de forma única el recopilador de eventos.	Cadena que debe tener al menos un carácter y no puede contener dos puntos (:) o espacios.	Sí
Base	Identifica la base del recopilador de eventos.	string	No
Nombre	Indica el nombre de la sesión ETW.	string	Sí
FileName	Indica el archivo al que se van a registrar los eventos.	string	Sí
Realtime	Indica si el recopilador de eventos funciona en tiempo real.	boolean	No	false
Privada	Si se establece en "true", indica una sesión en modo de usuario que se ejecuta en el mismo proceso que su proveedor de eventos. Si se establece en "false", indica una sesión global en modo de usuario.	boolean	No	false
ProcessPrivate	Si se establece en "true", indica una sesión en modo de usuario que se ejecuta en el mismo proceso que su proveedor de eventos y solo se debe controlar mediante el proceso que registró el proveedor. Si se establece en "false", indica una sesión global en modo de usuario. Use este atributo junto con el atributo Private .	boolean	No	false
Protección	Si se establece en "true", indica que solo los usuarios con privilegios administrativos y los derechos de acceso adecuados pueden controlar la sesión. Si se establece en "false", indica que todos los usuarios pueden controlar la sesión.	boolean	No	false

Elementos secundarios

Elemento	Descripción	Requisito	Valor predeterminado
BufferSize	Describe el tamaño de cada búfer, en KB.	Opcional, 1.	128
Búferes	Describe el número de búferes que se van a asignar al iniciar una sesión.	Opcional, 1.	64
StackCaching	Describe los atributos de almacenamiento en caché de la pila de recopiladores.	Opcional, 1.
MaximumFileSize	Describe el tamaño máximo del archivo de seguimiento.	Opcional, 1.
FileMax	Describe el número máximo de instancias del archivo de registro que ETW crea para el seguimiento del registrador automático.	Opcional, 1.

Elementos primarios

Elemento	Descripción
Perfiles	Representa una colección de recopiladores, proveedores y perfiles.

Comentarios

Las definiciones del recopilador del sistema deben preceder a las definiciones del recopilador de eventos.

Los recopiladores derivados heredan todos los atributos del recopilador base a menos que se especifiquen explícitamente en el recopilador derivado. Para obtener más información, vea Herencia.

Ejemplo

En el ejemplo de código siguiente se define un recopilador de eventos con 64 búferes de 128 KB cada uno.

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

Temas relacionados

Elements