CLR ETW 關鍵字和層級
Windows 事件追蹤 (ETW) 事件可依分類和層級篩選。 事件關鍵字CLR ETW 關鍵字可用來依分類篩選事件；它們會搭配執行階段提供者和取消提供者使用。 事件層級是依旗標識別。
CLR ETW 關鍵字
這些關鍵字是可結合以產生值的旗標。 實際上，當您呼叫命令列公用程式時，就會使用關鍵字的十六進位值，而非關鍵字名稱。
下表是這些關鍵字的說明：
CLR 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 取消關鍵字
下表列出 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 事件層級
ETW 事件也可以依照層級來篩選。 如果層級設定為 0x5，就會引發所有層級的事件，包括 0x5 以下 (屬於透過關鍵字啟用之分類的事件)。 如果層級設定為 0x2，就只會引發屬於層級 0x2 以下的事件。
這些層級具有下列意義：
0x5 - 詳細資訊
0x4 - 告知性
0x3 - 警告
0x2 - 錯誤
0x1 - 嚴重
0x0 - 永遠記錄
回到頁首