垃圾回收 ETW 事件
这些事件收集与垃圾回收相关的信息。 它们有助于诊断和调试，包括确定垃圾回收的执行次数、垃圾回收期间释放的内存量等。
此类别包括以下事件：
- GCStart_V1 事件
- GCEnd_V1 事件
- GCHeapStats_V1 事件
- GCHeapStats_V2 事件
- GCCreateSegment_V1 事件
- GCFreeSegment_V1 事件
- GCRestartEEBegin_V1 事件
- GCRestartEEEnd_V1 事件
- GCSuspendEE_V1 事件
- GCSuspendEEEnd_V1 事件
- GCAllocationTick_V2 事件
- GCAllocationTick_V3 事件
- GCFinalizersBegin_V1 事件
- GCFinalizersEnd_V1 事件
- GCCreateConcurrentThread_V1 事件
- GCTerminateConcurrentThread_V1 事件
GCStart_V1事件
下表显示了关键字和级别。 有关详细信息，请参阅 CLR ETW 关键字和级别。
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
信息性 （4） |
下表显示了事件信息：
| 事件 | 事件 ID | 在 |
|---|---|---|
GCStart_V1 |
1 | 垃圾回收已开始。 |
下表显示了事件数据：
| 字段名称 | 数据类型 | 描述 |
|---|---|---|
| 计数 | win：UInt32 | 垃圾回收 n。 |
| 深度 | win：UInt32 | 正在收集的代系。 |
| 原因 | win：UInt32 | 为何触发垃圾回收： 0x0 - 小型对象堆分配。 0x1 - 诱发。 0x2 - 内存不足。 0x3 - 空。 0x4 - 大型对象堆分配。 0x5 - 空间不足（对于小型对象堆）。 0x6 - 空间不足（对于大型对象堆）。 0x7 - 诱发但不是强制阻止。 0x8 - 压力测试。 0x9 - 观察到进程的终结器线程内存不足，并诱发 GC。 0x10 - 用户代码诱发 GC，并请求它是压缩 GC。 |
| 类型 | win：UInt32 | 0x0 - 阻止垃圾回收发生在后台垃圾回收之外。 0x1 - 后台垃圾回收。 0x2 - 在后台垃圾回收期间发生阻止垃圾回收。 |
| ClrInstanceID | win：UInt16 | CLR 或 CoreCLR 实例的唯一 ID。 |
GCEnd_V1 事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
信息性 （4） |
下表显示了事件信息：
| 事件 | 事件 ID | 在 |
|---|---|---|
GCEnd_V1 |
2 | 垃圾回收已结束。 |
下表显示了事件数据：
| 字段名称 | 数据类型 | 描述 |
|---|---|---|
| 计数 | win：UInt32 | 垃圾回收 n。 |
| 深度 | win：UInt32 | 收集的代系。 |
| ClrInstanceID | win：UInt16 | CLR 或 CoreCLR 实例的唯一 ID。 |
GCHeapStats_V1 事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
信息性 （4） |
下表显示了事件信息：
| 事件 | 事件 ID | 描述 |
|---|---|---|
GCHeapStats_V1 |
4 | 显示每个垃圾回收结束时的堆统计信息。 |
下表显示了事件数据：
| 字段名称 | 数据类型 | 描述 |
|---|---|---|
| GenerationSize0 | win：UInt64 | 第 0 代内存的大小（以字节为单位）。 |
| TotalPromotedSize0 | win：UInt64 | 从第 0 代升级到第 1 代的字节数。 |
| GenerationSize1 | win：UInt64 | 第 1 代内存的大小（以字节为单位）。 |
| TotalPromotedSize1 | win：UInt64 | 从第 1 代升级到第 2 代的字节数。 |
| GenerationSize2 | win：UInt64 | 第 2 代内存的大小（以字节为单位）。 |
| TotalPromotedSize2 | win：UInt64 | 在最后一个集合之后的第 2 代中幸存的字节数。 |
| GenerationSize3 | win：UInt64 | 大型对象堆的大小（以字节为单位）。 |
| TotalPromotedSize3 | win：UInt64 | 在上一个集合之后的大型对象堆中幸存下来的字节数。 |
| FinalizationPromotedSize | win：UInt64 | 准备好进行最终化的对象的总大小（以字节为单位）。 |
| FinalizationPromotedCount | win：UInt64 | 准备进行最终化的对象数。 |
| PinnedObjectCount | win：UInt32 | 固定的（不可移动）对象的数目。 |
| SinkBlockCount | win：UInt32 | 正在使用的同步块数。 |
| GCHandleCount | win：UInt32 | 正在使用的垃圾回收句柄数。 |
| ClrInstanceID | win：UInt16 | CLR 或 CoreCLR 实例的唯一 ID。 |
GCHeapStats_V2 事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
信息性 （4） |
下表显示了事件信息：
| 事件 | 事件 ID | 描述 |
|---|---|---|
GCHeapStats_V2 |
4 | 显示每个垃圾回收结束时的堆统计信息。 |
下表显示了事件数据：
| 字段名称 | 数据类型 | 描述 |
|---|---|---|
| GenerationSize0 | win：UInt64 | 第 0 代内存的大小（以字节为单位）。 |
| TotalPromotedSize0 | win：UInt64 | 从第 0 代升级到第 1 代的字节数。 |
| GenerationSize1 | win：UInt64 | 第 1 代内存的大小（以字节为单位）。 |
| TotalPromotedSize1 | win：UInt64 | 从第 1 代升级到第 2 代的字节数。 |
| GenerationSize2 | win：UInt64 | 第 2 代内存的大小（以字节为单位）。 |
| TotalPromotedSize2 | win：UInt64 | 在最后一个集合之后的第 2 代中幸存的字节数。 |
| GenerationSize3 | win：UInt64 | 大型对象堆的大小（以字节为单位）。 |
| TotalPromotedSize3 | win：UInt64 | 在上一个集合之后的大型对象堆中幸存下来的字节数。 |
| FinalizationPromotedSize | win：UInt64 | 准备好进行最终化的对象的总大小（以字节为单位）。 |
| FinalizationPromotedCount | win：UInt64 | 准备进行最终化的对象数。 |
| PinnedObjectCount | win：UInt32 | 固定的（不可移动）对象的数目。 |
| SinkBlockCount | win：UInt32 | 正在使用的同步块数。 |
| GCHandleCount | win：UInt32 | 正在使用的垃圾回收句柄数。 |
| ClrInstanceID | win：UInt16 | CLR 或 CoreCLR 实例的唯一 ID。 |
| GenerationSize4 | win：UInt64 | 固定对象堆的大小（以字节为单位）。 |
| TotalPromotedSize4 | win：UInt64 | 在最后一个集合之后固定的对象堆中幸存下来的字节数。 |
GCCreateSegment_V1事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
信息性 （4） |
下表显示了事件信息：
| 事件 | 事件 ID | 在 |
|---|---|---|
GCCreateSegment_V1 |
5 | 已创建新的垃圾回收段。 此外，在正在运行的进程上启用跟踪时，会为每个现有段引发此事件。 |
下表显示了事件数据：
| 字段名称 | 数据类型 | 描述 |
|---|---|---|
| 地址 | win：UInt64 | 段的地址。 |
| 大小 | win：UInt64 | 段的大小。 |
| 类型 | win：UInt32 | 0x0 - 小型对象堆。 0x1 - 大型对象堆。 0x2 - 只读堆。 |
| ClrInstanceID | win：UInt16 | CLR 或 CoreCLR 实例的唯一 ID。 |
请注意，垃圾回收器分配的段大小特定于实现，随时可能会更改，包括定期更新。 你的应用不应假设或依赖于特定的段大小，也不应尝试配置可用于段分配的内存量。
GCFreeSegment_V1事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
信息性 （4） |
下表显示了事件信息：
| 事件 | 事件 ID | 在 |
|---|---|---|
GCFreeSegment_V1 |
6 | 已释放垃圾回收段。 |
下表显示了事件数据：
| 字段名称 | 数据类型 | 描述 |
|---|---|---|
| 地址 | win：UInt64 | 段的地址。 |
| ClrInstanceID | win：UInt16 | CLR 或 CoreCLR 实例的唯一 ID。 |
GCRestartEEBegin_V1事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
信息性 （4） |
下表显示了事件信息：
| 事件 | 事件 ID | 在 |
|---|---|---|
GCRestartEEBegin_V1 |
7 | 已开始从公共语言运行时挂起恢复。 |
无事件数据。
GCRestartEEEnd_V1 事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
信息性 （4） |
下表显示了事件信息：
| 事件 | 事件 ID | 在 |
|---|---|---|
GCRestartEEEnd_V1 |
3 | 公共语言运行时挂起的恢复已结束。 |
无事件数据。
GCSuspendEE_V1 事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
信息性 （4） |
下表显示了事件信息：
| 事件 | 事件 ID | 在 |
|---|---|---|
GCSuspendEE_V1 |
9 | 开始暂停执行引擎进行垃圾回收。 |
下表显示了事件数据：
| 字段名称 | 数据类型 | 描述 |
|---|---|---|
| 原因 | win：UInt16 | 0x0 - 其他。 0x1 - 垃圾回收。 0x2 - 应用程序域关闭。 0x3 - 代码投向。 0x4 - 关闭。 0x5 - 调试器。 0x6 - 准备垃圾回收。 |
| 计数 | win：UInt32 | 当时的 GC 计数。 通常，你将在此之后看到一个后续的 GC Start 事件，其计数将是此计数 + 1，因为我们在垃圾回收期间增加 GC 索引。 |
| ClrInstanceID | win：UInt16 | CLR 或 CoreCLR 实例的唯一 ID。 |
GCSuspendEEEnd_V1 事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
信息性 （4） |
下表显示了事件信息：
| 事件 | 事件 ID | 在 |
|---|---|---|
GCSuspendEEEnd_V1 |
8 | 停止执行引擎进行垃圾回收。 |
无事件数据。
GCAllocationTick_V2 事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
详细 （5） |
下表显示了事件信息：
| 事件 | 事件 ID | 在 |
|---|---|---|
GCAllocationTick_V2 |
10 | 每次为每个对象堆分配大约 100 KB。 也就是说，SOH、LOH 和 POH 分别累积其已分配的字节。 在服务器 GC 中，这是按堆完成的。 |
下表显示了事件数据：
| 字段名称 | 数据类型 | 描述 |
|---|---|---|
| AllocationAmount | win：UInt32 | 分配大小（以字节为单位）。 此值对于小于 ULONG 长度（4,294,967,295 字节）的分配是准确的。 如果分配更大，则此字段包含截断的值。 将 AllocationAmount64 用于非常大的分配。 |
| AllocationKind | win：UInt32 | 0x0 - 小型对象分配（分配位于小型对象堆中）。 0x1 - 大型对象分配（分配位于大型对象堆中）。 0x2 - 固定对象分配（分配位于固定对象堆中）。 |
| ClrInstanceID | win：UInt16 | CLR 或 CoreCLR 实例的唯一 ID。 |
| AllocationAmount64 | win：UInt64 | 分配大小（以字节为单位）。 此值对于非常大的分配是准确的。 |
| TypeId | win：Pointer | MethodTable 的地址。 如果在此事件期间分配了多种类型的对象，则这是与分配的最后一个对象相对应的 MethodTable 的地址（导致超过 100 KB 阈值的对象）。 |
| TypeName | win：UnicodeString | 已分配的类型的名称。 如果在此事件期间分配了多种类型的对象，则这是分配的最后一个对象的类型（导致超过 100 KB 阈值的对象）。 |
| HeapIndex | win：UInt32 | 分配对象的堆。 使用工作站垃圾回收运行时，此值为 0（零）。 |
GCAllocationTick_V3事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
详细 （5） |
下表显示了事件信息：
| 事件 | 事件 ID | 在 |
|---|---|---|
GCAllocationTick_V2 |
10 | 每次为每个对象堆分配大约 100 KB。 也就是说，SOH、LOH 和 POH 分别累积其已分配的字节。 在服务器 GC 中，这是按堆完成的。 |
下表显示了事件数据：
| 字段名称 | 数据类型 | 描述 |
|---|---|---|
| AllocationAmount | win：UInt32 | 分配大小（以字节为单位）。 此值对于小于 ULONG 长度（4,294,967,295 字节）的分配是准确的。 如果分配更大，则此字段包含截断的值。 将 AllocationAmount64 用于非常大的分配。 |
| AllocationKind | win：UInt32 | 0x0 - 小型对象分配（分配位于小型对象堆中）。 0x1 - 大型对象分配（分配位于大型对象堆中）。 0x2 - 固定对象分配（分配位于固定对象堆中）。 |
| ClrInstanceID | win：UInt16 | CLR 或 CoreCLR 实例的唯一 ID。 |
| AllocationAmount64 | win：UInt64 | 分配大小（以字节为单位）。 此值对于非常大的分配是准确的。 |
| TypeId | win：Pointer | MethodTable 的地址。 如果在此事件期间分配了多种类型的对象，则这是与分配的最后一个对象相对应的 MethodTable 的地址（导致超过 100 KB 阈值的对象）。 |
| TypeName | win：UnicodeString | 已分配的类型的名称。 如果在此事件期间分配了多种类型的对象，则这是分配的最后一个对象的类型（导致超过 100 KB 阈值的对象）。 |
| HeapIndex | win：UInt32 | 分配对象的堆。 使用工作站垃圾回收运行时，此值为 0（零）。 |
| 地址 | win：Pointer | 最后一个已分配对象的地址。 |
GCFinalizersBegin_V1 事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
信息性 （4） |
下表显示了事件信息：
| 事件 | 事件 ID | 在 |
|---|---|---|
GCFinalizersBegin_V1 |
14 | 运行终结器的开始。 |
无事件数据。
GCFinalizersEnd_V1事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
信息性 （4） |
下表显示了事件信息：
| 事件 | 事件 ID | 在 |
|---|---|---|
GCFinalizersEnd_V1 |
13 | 运行终结器的结束。 |
下表显示了事件数据：
| 字段名称 | 数据类型 | 描述 |
|---|---|---|
| 计数 | win：UInt32 | 运行的终结器数。 |
| ClrInstanceID | win：UInt16 | CLR 或 CoreCLR 实例的唯一 ID。 |
GCCreateConcurrentThread_V1事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
信息性 （4） |
ThreadingKeyword（0x10000） |
信息性 （4） |
下表显示了事件信息：
| 事件 | 事件 ID | 在 |
|---|---|---|
GCCreateConcurrentThread_V1 |
11 | 已创建并发垃圾回收线程。 |
无事件数据。
GCTerminateConcurrentThread_V1事件
下表显示了关键字和级别：
| 引发事件的关键字 | 水平 |
|---|---|
GCKeyword （0x1） |
信息性 （4） |
ThreadingKeyword（0x10000） |
信息性 （4） |
下表显示了事件信息：
| 事件 | 事件 ID | 在 |
|---|---|---|
GCTerminateConcurrentThread_V1 |
12 | 并发垃圾回收线程已终止。 |
无事件数据。
