SystemCollector

Updated: October 20, 2013

Applies To: Windows 8, Windows 8.1

Describes the configurations to enable the Event Tracing for Windows® (ETW) kernel-mode session.

<WindowsPerformanceRecorder>
     <Profiles>
          <SystemCollector>


<SystemCollector Id       = IdType
                 Base     = string
                 Name     = "NT Kernel Logger" | "Circular Kernel Context Logger"
                 Realtime = boolean>

  <!-- Child elements -->
  BufferSize,
  Buffers,
  StackCaching

</SystemCollector>

 

Attribute Description Data type Required Default

Id

Uniquely identifies the system collector.

String that must have at least one character and cannot contain colons (:) or spaces.

Yes

Base

Identifies the base of the system collector. Derived collectors have all the attributes of the base collector. These can be overridden by explicitly specifying them in the derived collector.

string

No

Name

Indicates the name of the system collector.

This attribute can have one of the following values:

  • NT Kernel Logger

  • Circular Kernel Context Logger

Yes

Realtime

Indicates whether the collector works in real time.

boolean

No

false

 

Element Description Requirement.

BufferSize

Describes the size of each buffer, in KB.

Required, exactly 1.

Buffers

Describes the number of buffers to be allocated when starting a session.

Required, exactly 1.

StackCaching

Describes stack caching attributes of collectors.

 

Element Description

Profiles

Represents a collection of collectors, providers, and profiles.

System collector definitions should precede event collector definitions.

The following code example defines a system collector.

<SystemCollector
  Id="WPRSystemCollector”
  Name="NT Kernel Logger"
  FileName="WPRKernel.etl">
  <BufferSize Value="512"/>
  <Buffers Value="3" PercentageOfTotalMemory="true"/>
</SystemCollector>

Other Resources

Elements

Show:
© 2014 Microsoft