CLR ETW 关键字和级别

Windows (ETW) 事件的事件跟踪可以按类别和级别进行筛选。 事件 CLR ETW 关键字 启用按类别筛选事件；它们用于运行时提供程序和断开提供程序的组合。 事件级别 由标志来标识。

CLR ETW 关键字

关键字是可以组合以生成值的标志。 在实践中，当调用命令行实用程序时，使用关键字的十六进制值而非关键字名称。

下表描述了这些关键字：

• CLR ETW 运行时关键字

• CLR ETW 断开关键字

• 用于运行时提供程序的符号解析的关键字组合

• 用于断开提供程序的符号解析的关键字组合

CLR ETW 运行时关键字

下表列出了 CLR ETW 运行时关键字、它们的值以及它们的用途。

运行时关键字名称	值	目的
GCKeyword	0x00000001	启用 垃圾回收事件的回收。
LoaderKeyword	0x00000008	启用 加载程序事件的回收。
JITKeyword	0x00000010	启用 实时 (JIT) 事件的回收。
NGenKeyword	0x00000020	启用本机映像方法（由本机映像生成器 Ngen.exe 处理的方法）的事件的收集；与 StartEnumerationKeyword 和 EndEnumerationKeyword一起使用。 此关键字具有高开销。 它将在每个加载的 NGen 模块内生成每个方法的事件。 只要有可能，我们建议使用由分析工具生成的程序数据库 (PDB) 从 NGen 模块检索有关方法的信息，而不是使用此关键字。 另请参阅此表后面的 OverrideAndSuppressNGenEventsKeyword 。
StartEnumerationKeyword	0x00000040	启用运行时中所有方法的枚举；与 NGenKeyword配合使用。
EndEnumerationKeyword	0x00000080	启用运行时中销毁的所有方法的枚举；与 JITKeyword 和 NGenKeyword配合使用。
SecurityKeyword	0x00000400	启用 安全事件的回收。
AppDomainResourceManagementKeyword	0x00000800	启用应用程序域级别的资源监视事件的回收。
JITTracingKeyword	0x00001000	启用 JIT 跟踪事件的回收。
InteropKeyword	0x00002000	启用 互操作事件的回收。
ContentionKeyword	0x00004000	启用 争用事件的回收。
ExceptionKeyword	0x00008000	启用 异常事件的回收。
ThreadingKeyword	0x00010000	启用 线程池事件的回收。
OverrideAndSuppressNGenEventsKeyword	0x00040000	（可在 .NET Framework 4.5 及更高版本中使用。）取消高开销 NGenKeyword 关键字，并防止生成 NGen 模块内方法的事件。 从 .NET Framework 4.5 开始，分析工具应一并使用 OverrideAndSuppressNGenEventsKeyword 和 NGenKeyword 以取消生成 NGen 模块内方法的事件。 这使分析工具能够使用更高效的 NGen PDB 来获取 NGen 模块中方法的相关信息。 .NET Framework 4 及更早版本中的 CLR 不支持 NGen PDB 的创建。 在这些早期版本中，CLR 将不识别 OverrideAndSuppressNGenEventsKeyword 并将处理 NGenKeyword 以生成 NGen 模块内方法的事件。
PerfTrackKeyWord	0x2000000	启用 ModuleLoad 和 ModuleRange 事件的回收。
StackKeyword	0x40000000	启用 CLR 堆栈跟踪事件的回收。

CLR ETW 断开关键字

下表列出了 CLR ETW 断开关键字、它们的值以及它们的用途。

断开关键字名称	值	目的
LoaderRundownKeyword	0x00000008	当与 StartRundownKeyword 和 EndRundownKeyword一起使用时启用加载程序事件的回收。
JitRundownKeyword	0x00000010	当与 DCStart 和 DCEnd 一起使用时启用 JIT 编译的方法的方法 StartRundownKeyword 和 EndRundownKeyword事件的回收。
NGenRundownKeyword	0x00000020	当与 DCStart 和 DCEnd 一起使用时启用 NGen 本机映像方法的方法 StartRundownKeyword 和 EndRundownKeyword事件的回收。 此关键字具有高开销。 它将在每个加载的 NGen 模块内生成每个方法的事件。 只要有可能，我们建议使用由分析工具生成的程序数据库 (PDB) 从 NGen 模块检索有关方法的信息，而不是使用此关键字。 另请参阅此表后面的 OverrideAndSuppressNGenEventsRundownKeyword 。
StartRundownKeyword	0x00000040	在开始断开期间启用系统状态的枚举。
EndRundownKeyword	0x00000100	在结束断开期间启用系统状态的枚举。
AppDomainResourceManagementRundownKeyword	0x00000800	当与 AppDomain 或 StartRundownKeyword 一起使用时启用 EndRundownKeyword级别的资源监视的事件的回收。
ThreadingKeyword	0x00010000	启用线程池事件的回收。
OverrideAndSuppressNGenEventsRundownKeyword	0x00040000	（可在 .NET Framework 4.5 及更高版本中使用。）取消高开销 NGenRundownKeyword 关键字，并防止生成 NGen 模块内方法的事件。 从 .NET Framework 4.5 开始，分析工具应一并使用 OverrideAndSuppressNGenEventsRundownKeyword 和 NGenRundownKeyword 以取消生成 NGen 模块内方法的事件。 这使分析工具能够使用更高效的 NGen PDB 来获取 NGen 模块中方法的相关信息。 .NET Framework 4 及更早版本中的 CLR 不支持 NGen PDB 的创建。 在这些早期版本中，CLR 将不识别 OverrideAndSuppressNGenEventsRundownKeyword 并将处理 NGenRundownKeyword 以生成 NGen 模块内方法的事件。
PerfTrackKeyWord	0x2000000	启用 ModuleDCStart、 ModuleDCEnd、 ModuleRangeDCStart和 ModuleRangeDCEnd 事件的回收。

用于运行时提供程序的符号解析的关键字组合

关键字和标志	应用程序域、程序集、模块加载/卸载事件	方法加载/卸载事件（动态事件除外）	动态方法加载/销毁事件
LoaderKeyword	加载和卸载事件。	无。	无。
JITKeyword （+ StartEnumerationKeyword 不添加任何内容）	无。	加载事件。	加载和卸载事件。
JITKeyword + EndEnumerationKeyword	无。	加载和卸载事件。	加载和卸载事件。
NGenKeyword	无。	无。	不适用。
NGenKeyword + StartEnumerationKeyword	无。	加载事件。	不适用。
NGenKeyword + EndEnumerationKeyword	无。	卸载事件。	不适用。

用于断开提供程序的符号解析的关键字组合

关键字和标志	应用程序域、程序集、模块 DCStart/DCEnd 事件	方法 DCStart/DCEnd 事件（包括动态方法事件）
LoaderRundownKeyword + StartRundownKeyword	DCStart 事件。	无。
LoaderRundownKeyword + EndRundownKeyword	DCEnd 事件。	无。
JITKeyword + StartRundownKeyword	无。	DCStart 事件。
JITKeyword + EndRundownKeyword	无。	DCEnd 事件。
NGenKeyword + StartRundownKeyword	无。	DCStart 事件。
NGenKeyword + EndRundownKeyword	无。	DCEnd 事件。

ETW 事件级别

ETW 事件还可按级别进行筛选。 如果级别设置为 0x5，则会引发包括 0x5 及以下级别的事件（这些事件属于通过关键字启用的类别）。 如果级别设置为 0x2，则只会引发 0x2 及以下级别的事件。

级别具有以下含义：

0x5 - 详细

0x4 - 信息性

0x3 - 警告

0x2 - 错误

0x1 - 严重

0x0 - LogAlways

请参阅

• CLR ETW 提供程序
• CLR ETW 事件
• 公共语言运行时中的 ETW 事件