EventCollector

  • 项目

表示配置文件的事件收集器。

元素层次结构

语法

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

特性和元素

特性

属性 说明 数据类型 必须 默认
Id 唯一地标识事件收集器。 字符串，必须至少包含一个字符，且不能包含冒号 (:) 或空格。 是
Base 标识事件收集器的基础。 string 否
名称 指示 ETW 会话的名称。 字符串 是
FileName 指示要将事件记录到的文件。 字符串 是
Realtime 指示事件收集器是否实时运行。 boolean 否 false
专用 如果设置为“true”，表示在与事件提供程序相同的进程中运行的用户模式会话。 如果设置为“false"，表示全局用户模式会话。 boolean 否 false
ProcessPrivate 如果设置为“true“，表示在与事件提供程序相同的进程中运行的用户模式会话，并且应仅由已注册该提供程序的进程控制。 如果设置为“false"，表示全局用户模式会话。 将此属性与“Private”属性结合使用。 boolean 否 false
安全 如果设置为“true”，表示只有具有管理权限和适当访问权限的用户才能控制会话。 如果设置为“false”，表示所有用户均可控制会话。 boolean 否 false

子元素

元素 说明 要求 默认
BufferSize 描述每个缓冲区的大小（以 KB 为单位）。 可选，1。 128
Buffers 描述启动会话时要分配的缓冲区数。 可选，1。 64
StackCaching 描述收集器的堆栈缓存属性。 可选，1。
MaximumFileSize 描述最大跟踪文件大小。 可选，1。
FileMax 描述 ETW 为自动记录器跟踪创建的日志文件的最大实例数。 可选，1。

父元素

元素 说明
Profiles 表示收集器、提供程序和配置文件的集合。

注解

系统收集器定义必须位于事件收集器定义之前。

派生收集器会继承基础收集器的所有属性，除非在派生收集器中明确指定这些属性。 有关详细信息，请参阅继承。

示例

下面的代码示例定义了一个事件收集器，其中包含 64 个缓冲区，每个缓冲区 128 KB。

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

元素