ETW Events in Task Parallel Library and PLINQ
Both the Task Parallel Library and PLINQ generate Event Trace for Windows (ETW) events that you can use to profile and troubleshoot applications by using tools such as the Windows Performance Analyzer. However, in most scenarios, the best way to profile parallel application code is to use the Concurrency Visualizer in Visual Studio.
Task Parallel Library ETW Events
In the EVENT_HEADER structure, the ProviderId GUID for events generated by Parallel.For, Parallel.ForEach and Parallel.Invoke is:
0x2e5dba47, 0xa3d2, 0x4d16, 0x8e, 0xe0, 0x66, 0x71, 0xff, 0xdc, 0xd7, 0xb5
Parallel Loop Begin
EVENT_DESCRIPTOR.Task = 1
EVENT_DESCRIPTOR.Id = 1
User Data
| Name | Type | Description |
|---|---|---|
| OriginatingTaskSchedulerID | System.Int32 | The ID of the TaskScheduler that started the loop. |
| OriginatingTaskID | System.Int32 | The ID of the task that started the loop. |
| ForkJoinContextID | System.Int32 | A unique identifier used to indicate nesting and pairs for events with fork/join semantics. |
| OperationType | System.Int32 | Indicates the type of loop: 1 = ParallelInvoke 2 = ParallelFor 3 = ParallelForEach |
| InclusiveFrom | System.Int64 | The starting value of the loop counter |
| ExclusiveTo | System.Int64 | The ending value of the loop counter |
Parallel Loop End
EVENT_DESCRIPTOR.Task = 2
EVENT_DESCRIPTOR.Id = 2
User Data
| Name | Type | Description |
|---|---|---|
| OriginatingTaskSchedulerID | System.Int32 | The ID of the TaskScheduler that started the loop. |
| OriginatingTaskID | System.Int32 | The ID of the task that started the loop. |
| ForkJoinContextID | System.Int32 | A unique identifier used to indicate nesting and pairs for events with fork/join semantics. |
| totalIterations | System.Int64 | The total number of iterations |
Parallel Invoke Begin
EVENT_DESCRIPTOR.Task = 3
EVENT_DESCRIPTOR.Id = 3
User Data
| Name | Type | Description |
|---|---|---|
| OriginatingTaskSchedulerID | System.Int32 | The ID of the TaskScheduler that started the loop. |
| OriginatingTaskID | System.Int32 | The ID of the task that started the loop. |
| ForkJoinContextID | System.Int32 | A unique identifier used to indicate nesting and pairs for events with fork/join semantics. |
| totalIterations | System.Int64 | The total number of iterations |
| operationType | System.Int32 | Indicates the type of loop: 1 = ParallelInvoke 2 = ParallelFor 3 = ParallelForEach |
| ActionCount | System.Int32 | The number of actions that will be executed in the parallel invoke. |
Parallel Invoke End
EVENT_DESCRIPTOR.Task = 4
EVENT_DESCRIPTOR.Id = 4
User Data
| Name | Type | Description |
|---|---|---|
| OriginatingTaskSchedulerID | System.Int32 | The ID of the TaskScheduler that started the loop. |
| OriginatingTaskID | System.Int32 | The ID of the task that started the loop. |
| ForkJoinContextID | System.Int32 | A unique identifier used to indicate nesting and pairs for events with fork/join semantics. |
PLINQ ETW Events
The EVENT_HEADER.ProviderId GUID for PLINQ is:
0x159eeeec, 0x4a14, 0x4418, 0xa8, 0xfe, 0xfa, 0xab, 0xcd, 0x98, 0x78, 0x87
Parallel Query Begin
EVENT_DESCRIPTOR.Task = 1
EVENT_DESCRIPTOR.Id = 1
User Data
| Name | Type | Description |
|---|---|---|
| OriginatingTaskSchedulerID | System.Int32 | The ID of the TaskScheduler that started the loop. |
| OriginatingTaskID | System.Int32 | The ID of the task that started the loop. |
| QueryID | System.Int32 | A unique query identifier. |
Parallel Query End
EVENT_DESCRIPTOR.Task = 2
EVENT_DESCRIPTOR.Id = 2
User Data
| Name | Type | Description |
|---|---|---|
| OriginatingTaskSchedulerID | System.Int32 | The ID of the TaskScheduler that started the loop. |
| OriginatingTaskID | System.Int32 | The ID of the task that started the loop. |
| QueryID | System.Int32 | A unique query identifier. |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for