大网数据广告活动
.NET 与 C# 开发

线程池 ETW 事件

· 52CE 我爱测

- 工作线程池事件:提供有关应用程序如何使用线程池以及工作负荷如何影响并发控制的信息。

这些事件收集有关工作线程和 I/O 线程的信息。

存在两组线程池事件:

  • 工作线程池事件:提供有关应用程序如何使用线程池以及工作负荷如何影响并发控制的信息。

  • I/O 线程池事件:提供有关线程池中创建、停用、恢复或终止的 I/O 线程的信息。

工作线程池事件

这些事件与运行时工作线程池相关,并提供有关线程事件的通知(例如,创建或停止线程时)。 工作线程池使用自适应算法进行并发控制,其中的线程数基于测得的吞吐量来计算。 工作线程池事件可用于了解应用程序如何使用线程池,以及某些工作负荷可能会对并发控制怎样的影响。

ThreadPoolWorkerThreadStart 和 ThreadPoolWorkerThreadStop

下表显示这些事件的关键字和级别。 (有关详细信息,请参阅 CLR ETW Keywords and Levels。)

引发事件的关键字 级别
ThreadingKeyword (0x10000) 信息性 (4)

下表显示了事件信息。

Event 事件 ID 在发生以下情况时引发
ThreadPoolWorkerThreadStart 50 创建工作线程。
ThreadPoolWorkerThreadStop 51 停止工作线程。
ThreadPoolWorkerThreadRetirementStart 52 停用工作线程。
ThreadPoolWorkerThreadRetirementStop 53 停用的工作线程再次变为活动状态。

下表显示了事件数据。

字段名 数据类型 描述
ActiveWorkerThreadCount win:UInt32 可用于处理工作的工作线程数,包括已在处理工作的工作线程。
RetiredWorkerThreadCount win:UInt32 不能用于处理工作但被保留以防之后需要更多线程的工作线程数。
ClrInstanceID Win:UInt16 CLR 或 CoreCLR 的实例的唯一 ID。

ThreadPoolWorkerThreadAdjustment

这些线程池事件提供用于了解和调试线程注入(并发控制)算法行为的信息。 这些信息由工作线程池在内部使用。

ThreadPoolWorkerThreadAdjustmentSample

下表显示了关键字和级别。

引发事件的关键字 级别
ThreadingKeyword (0x10000) 信息性 (4)

下表显示了事件信息。

Event 事件 ID 描述
ThreadPoolWorkerThreadAdjustmentSample 54 指一个示例的信息收集,即具有一定并发级别的即时吞吐量测量。

下表显示了事件数据。

字段名 数据类型 描述
吞吐量 win:Double 每个时间单位的完成数。
ClrInstanceID Win:UInt16 CLR 或 CoreCLR 的实例的唯一 ID。
ThreadPoolWorkerThreadAdjustmentAdjustment

下表显示了关键字和级别。

引发事件的关键字 级别
ThreadingKeyword (0x10000) 信息性 (4)

下表显示了事件信息。

Event 事件 ID 描述
ThreadPoolWorkerThreadAdjustmentAdjustment 55 当线程注入(爬山)算法确定并发级别发生更改时,在控件中记录更改。

下表显示了事件数据。

字段名 数据类型 描述
AverageThroughput win:Double 测量示例的平均吞吐量。
NewWorkerThreadCount win:UInt32 新的活动工作线程数。
原因 win:UInt32 调整的原因。 0x00 - 预热。 0x01 - 初始化。 0x02 - 随机移动。 0x03 - 攀移。 0x04 - 更改点。 0x05 - 稳定。 0x06 - 匮乏。 0x07 - 线程已超时。
ClrInstanceID Win:UInt16 CLR 或 CoreCLR 的实例的唯一 ID。
ThreadPoolWorkerThreadAdjustmentStats

下表显示了关键字和级别。

引发事件的关键字 级别
ThreadingKeyword (0x10000) 信息性 (4)

下表显示了事件信息。

Event 事件 ID 描述
ThreadPoolWorkerThreadAdjustmentStats 56 在线程池上收集数据。

下表显示了事件数据。

字段名 数据类型 描述
持续时间 win:Double 收集这些统计信息的时间量(以秒为单位)。
吞吐量 win:Double 在此间隔期间每秒完成的平均数量。
ThreadWave win:Double 保留以供内部使用。
ThroughputWave win:Double 保留以供内部使用。
ThroughputErrorEstimate win:Double 保留以供内部使用。
ThroughputErrorEstimate win:Double 保留以供内部使用。
ThroughputWave win:Double 在此间隔期间因活动工作线程计数变化导致的相对吞吐量变化。
Confidence win:Double ThroughputRatio 字段的有效性测量。
NewcontrolSetting win:Double 将作为活动线程计数未来变化基线的活动工作线程数。
NewThreadWaveMagnitude Win:UInt16 活动线程计数的未来变化量值。
ClrInstanceID Win:UInt16 CLR 或 CoreCLR 的实例的唯一 ID。

返回页首

I/O 线程事件

这些线程池事件针对 I/O 线程池(完成端口)中的线程发生,该过程是异步的。

IOThreadCreate_V1

下表显示了关键字和级别。

引发事件的关键字 级别
ThreadingKeyword (0x10000) 信息性 (4)

下表显示了事件信息。

Event 事件 ID 在发生以下情况时引发
IOThreadCreate_V1 44 在线程池中创建 I/O 线程。

下表显示了事件数据。

字段名 数据类型 描述
计数 win:UInt64 I/O 线程数,包括新创建的线程。
NumRetired win:UInt64 已停用的工作线程数。
ClrInstanceID Win:UInt16 CLR 或 CoreCLR 的实例的唯一 ID。

IOThreadRetire_V1

下表显示了关键字和级别。

引发事件的关键字 级别
ThreadingKeyword (0x10000) 信息性 (4)

下表显示了事件信息。

Event 事件 ID 在发生以下情况时引发
IOThreadRetire_V1 46 I/O 线程变为停用候选项。

下表显示了事件数据。

字段名 数据类型 描述
计数 win:UInt64 线程池中剩余的 I/O 线程数。
NumRetired win:UInt64 已停用的 I/O 线程数。
ClrInstanceID Win:UInt16 CLR 或 CoreCLR 的实例的唯一 ID。

IOThreadUnretire_V1

下表显示了关键字和级别。

引发事件的关键字 级别
ThreadingKeyword (0x10000) 信息性 (4)

下表显示了事件信息。

Event 事件 ID 在发生以下情况时引发
IOThreadUnretire_V1 47 I/O 线程因在该线程变为停用候选项后的等待期间内达到 I/O 而恢复使用。

下表显示了事件数据。

字段名 数据类型 描述
计数 win:UInt64 线程池中的 I/O 线程数,包括这一个。
NumRetired win:UInt64 已停用的 I/O 线程数。
ClrInstanceID Win:UInt16 CLR 或 CoreCLR 的实例的唯一 ID。

IOThreadTerminate

下表显示了关键字和级别。

引发事件的关键字 级别
ThreadingKeyword (0x10000) 信息性 (4)

下表显示了事件信息。

Event 事件 ID 在发生以下情况时引发
IOThreadTerminate 45 在线程池中创建 I/O 线程。

下表显示了事件数据。

字段名 数据类型 描述
计数 win:UInt64 线程池中剩余的 I/O 线程数。
NumRetired win:UInt64 已停用的 I/O 线程数。
ClrInstanceID Win:UInt16 CLR 或 CoreCLR 的实例的唯一 ID。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 mairaw)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。