Share via

HypervisorEventCollector

  • Article

Represents a hypervisor event collector for the profile.

Element Hierarchy

Syntax

<HypervisorEventCollector Id             = IdType
                Base           = string
                Name           = string
                Realtime       = boolean
                MergeAlone     = boolean>

  <!-- Child elements -->
  BufferSize,
  BuffersPerCPU,
  MaximumFileSize,
  FileMax
</HypervisorEventCollector>

Attributes and Elements

Attributes

Attribute Description Data type Required Default
Id Uniquely identifies the event collector. String that must have at least one character and cannot contain colons (:) or spaces. Yes
Base Identifies the base of the event collector. string No
Name Indicates the name of the ETW session. string Yes
Realtime Indicates whether the event collector operates in real time. boolean No false
MergeAlone Indicates whether the hypervisor session will do merge on its own. The merged file will save to TraceFileName.HyperV.etl boolean No false

Child Elements

Element Description Requirement
BufferSize Describes the size of each buffer, in KB. Required
BuffersPerCPU Describes the number of buffers to be allocated per CPU Required
MaximumFileSize Describes maximum trace file size. No
FileMax Describes the maximum number of instances of the log file that ETW creates for Autologger trace. No

Parent Elements

Element Description
Profiles Represents a collection of collectors, providers, and profiles.

Remarks

HypervisorEventCollector tracing session works only in FileMode LoggingMode.

Example

The following code example defines an HypervisorEventCollector with 4 buffers per CPU of 128 KB each. If there are 16 CPUs in the system, total number of buffers would be 64.

<HypervisorEventCollector
  Id="WPREventCollector"
  Name="WPR Event Collector"> 
  <BufferSize
    Value="128"/> 
  <BuffersPerCPU
    Value="4"/>
</EventCollector>

Elements