CLR ETW 關鍵字和層級

Windows 事件追蹤 (ETW) 事件可依分類和層級篩選。事件關鍵字CLR ETW 關鍵字可用來依分類篩選事件；它們會搭配執行階段提供者和取消提供者使用。事件層級是依旗標識別。

CLR ETW 關鍵字

這些關鍵字是可結合以產生值的旗標。實際上，當您呼叫命令列公用程式時，就會使用關鍵字的十六進位值，而非關鍵字名稱。

下表是這些關鍵字的說明：

下表列出 CLR ETW 執行階段關鍵字、其值和目的。

執行階段關鍵字名稱	值	目的
GCKeyword	0x00000001	啟用記憶體回收事件的收集。
LoaderKeyword	0x00000008	啟用載入器事件的收集。
JITKeyword	0x00000010	啟用 Just-In-Time (JIT) 事件的收集。
NGenKeyword	0x00000020	啟用原生映像方法 (原生映像產生器 (Ngen.exe) 所處理的方法) 之事件的收集；可搭配 StartEnumerationKeyword 和 EndEnumerationKeyword 使用。
StartEnumerationKeyword	0x00000040	啟用執行階段中所有方法的列舉；可搭配 NGenKeyword 使用。
EndEnumerationKeyword	0x00000080	啟用在執行階段中終結之所有方法的列舉；可搭配 JITKeyword 和 NGenKeyword 使用。
SecurityKeyword	0x00000400	啟用安全性事件的收集。
AppDomainResourceManagementKeyword	0x00000800	啟用位於應用程式定義域層級之資源監視事件的收集。
JITTracingKeyword	0x00001000	啟用 JIT 追蹤事件的收集。
InteropKeyword	0x00002000	啟用 Interop 事件的收集。
ContentionKeyword	0x00004000	啟用爭用事件的收集。
ExceptionKeyword	0x00008000	啟用例外狀況事件的收集。
ThreadingKeyword	0x00010000	啟用執行緒集區事件的收集。
StackKeyword	0x40000000	啟用 CLR 堆疊追蹤事件的收集。

回到頁首

下表列出 CLR ETW 取消關鍵字、其值和目的。

取消關鍵字名稱	值	目的
LoaderRundownKeyword	0x00000008	搭配 StartRundownKeyword 和 EndRundownKeyword 使用時，可啟用載入器事件的收集。
JitRundownKeyword	0x00000010	搭配 StartRundownKeyword 和 EndRundownKeyword 使用時，可針對 JIT 編譯的方法啟用方法 DCStart 和 DCEnd 事件的收集。
NGenRundownKeyword	0x00000020	搭配 StartRundownKeyword 和 EndRundownKeyword 使用時，可針對 NGEN 原生映像方法啟用方法 DCStart 和 DCEnd 事件的收集。
StartRundownKeyword	0x00000040	在開始取消期間啟用系統狀態的列舉。
EndRundownKeyword	0x00000100	在結束取消期間啟用系統狀態的列舉。
AppDomainResourceManagementRundownKeyword	0x00000800	搭配 StartRundownKeyword 或 EndRundownKeyword 使用時，可啟用位於 AppDomain 層級之資源監視事件的收集。

回到頁首

關鍵字和旗標	應用程式定義域、組件、模組載入/卸載事件	方法載入/卸載事件 (動態事件除外)	動態方法載入/終結事件
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 事件也可以依照層級來篩選。如果層級設定為 0x5，就會引發所有層級的事件，包括 0x5 以下 (屬於透過關鍵字啟用之分類的事件)。如果層級設定為 0x2，就只會引發屬於層級 0x2 以下的事件。

這些層級具有下列意義：

0x5 - 詳細資訊

0x4 - 告知性

0x3 - 警告

0x2 - 錯誤

0x1 - 嚴重

0x0 - 永遠記錄

回到頁首