載入器 ETW 事件

  • 發行項

這些事件會收集與載入和卸除應用程式域、元件和模組相關的資訊。

所有的載入器事件都會在 LoaderKeyword (0x8) 關鍵字底下引發。 DCStart 和 DCEnd 事件會在啟用 StartRundown/EndRundown 時，於 LoaderRundownKeyword (0x8) 底下引發。 (如需詳細資訊，請參閱 CLR ETW Keywords and Levels)。

應用程式定義域事件

下表說明關鍵字和層級。

引發事件的關鍵字 活動 層級
LoaderKeyword (0x8) AppDomainLoad_V1 和 AppDomainUnLoad_V1 告知性 (4)
LoaderRundownKeyword (0x8) +

StartRundownKeyword		 AppDomainDCStart_V1 告知性 (4)
LoaderRundownKeyword (0x8) +

EndRundownKeyword		 AppDomainDCEnd_V1 告知性 (4)

下表說明事件資訊。

活動 事件識別碼 描述
AppDomainLoad_V1 (針對所有應用程式定義域記錄) 156 每當在處理序的存留期間建立應用程式定義域時引發。
AppDomainUnLoad_V1 157 每當在處理序的存留期間終結應用程式定義域時引發。
AppDomainDCStart_V1 157 在開始取消期間列舉應用程式定義域。
AppDomainDCEnd_V1 158 在結束取消期間列舉應用程式定義域。

下表說明事件資料。

欄位名稱 資料類型 描述
AppDomainID win:UInt64 應用程式定義域的唯一識別項。
AppDomainFlags win:UInt32 0x1：預設定義域。

0x2：可執行檔。

0x4：應用程式定義域，位元 28-31：這個定義域的共用原則。

0：共用的定義域。
AppDomainName win:UnicodeString 易記的應用程式定義域名稱。 在處理序的存留期間可能會變更。
AppDomainIndex win:UInt32 這個應用程式定義域的索引。
ClrInstanceID win:UInt16 CLR 或 CoreCLR 執行個體的唯一 ID。

CLR 載入器組件事件

下表說明關鍵字和層級。

引發事件的關鍵字 活動 層級
LoaderKeyword (0x8) AssemblyLoad 和 AssemblyUnload 告知性 (4)
LoaderRundownKeyword (0x8) +

StartRundownKeyword		 AssemblyDCStart 告知性 (4)
LoaderRundownKeyword (0x8) +

EndRundownKeyword		 AssemblyDCEnd 告知性 (4)

下表說明事件資訊。

活動 事件識別碼 描述
AssemblyLoad_V1 154 載入組件時引發。
AssemblyUnload_V1 155 卸載組件時引發。
AssemblyDCStart_V1 155 在開始取消期間列舉組件。
AssemblyDCEnd_V1 156 在結束取消期間列舉組件。

下表說明事件資料。

欄位名稱 資料類型 描述
AssemblyID win:UInt64 組件的唯一 ID。
AppDomainID win:UInt64 這個組件之定義域的 ID。
BindingID win:UInt64 可唯一識別組件繫結的 ID。
AssemblyFlags win:UInt32 0x1：定義域中性組件。

0x2：動態組件。

0x4：組件具有原生映像。

0x8：可回收組件。
AssemblyName win:UnicodeString 完整的組件名稱。
ClrInstanceID win:UInt16 CLR 或 CoreCLR 執行個體的唯一 ID。

模組事件

下表說明關鍵字和層級。

引發事件的關鍵字 活動 層級
LoaderKeyword (0x8) ModuleLoad_V2 和 ModuleUnload_V2 告知性 (4)
LoaderRundownKeyword (0x8) +

StartRundownKeyword		 ModuleDCStart_V2 告知性 (4)
LoaderRundownKeyword (0x8) +

EndRundownKeyword		 ModuleDCEnd_V2 告知性 (4)

下表說明事件資訊。

活動 事件識別碼 描述
ModuleLoad_V2 152 在處理序的存留期間載入模組時引發。
ModuleUnload_V2 153 在處理序的存留期間卸載模組時引發。
ModuleDCStart_V2 153 在開始取消期間列舉模組。
ModuleDCEnd_V2 154 在結束取消期間列舉模組。

下表說明事件資料。

欄位名稱 資料類型 描述
ModuleID win:UInt64 模組的唯一 ID。
AssemblyID win:UInt64 這個模組所在之組件的 ID。
ModuleFlags win:UInt32 0x1：定義域中性模組。

0x2：模組具有原生映像。

0x4：動態模組。

0x8：資訊清單模組。
Reserved1 win:UInt32 保留的欄位。
ModuleILPath win:UnicodeString 模組的通用中繼語言 （CIL） 映射路徑，如果它是動態元件，則為動態模組名稱（Null 終止）。
ModuleNativePath win:UnicodeString 模組原生映像的路徑 (如果存在的話 (以 Null 終止))。
ClrInstanceID win:UInt16 CLR 或 CoreCLR 執行個體的唯一 ID。
ManagedPdbSignature win:GUID 符合此模組的受管理程式資料庫 (PDB) 的 GUID 簽章。 (請參閱＜備註＞)。
ManagedPdbAge win:UInt32 寫入至受管理 PDB 並符合此模組的保留時間數值。 (請參閱＜備註＞)。
ManagedPdbBuildPath win:UnicodeString 符合此模組之受管理 PDB 建立位置的目標路徑。 在某些情況下，這可能只是檔案名稱。 (請參閱＜備註＞)。
NativePdbSignature win:GUID 符合此模組之原生映像產生器 (NGen) PDB 的 GUID 簽章 (如果有的話)。 (請參閱＜備註＞)。
NativePdbAge win:UInt32 寫入符合本模組之 NGen PDB 的的保留時間數值 (如果有的話)。 (請參閱＜備註＞)。
NativePdbBuildPath win:UnicodeString 符合此模組之 NGen PDB 建立位置的目標路徑。 在某些情況下，這可能只是檔案名稱。 (請參閱＜備註＞)。

備註

  • 名稱中擁有 "Pdb" 的欄位可供程式碼剖析工具使用，以找出與剖析工作階段時載入之模組相符的 PDB。 這些欄位的值對應於寫入模組中 IMAGE_DIRECTORY_ENTRY_DEBUG 區段的資料，且通常用於偵錯工具以協助尋找符合已載入模組的 PDB。

  • 以 「ManagedPdb」 開頭的功能變數名稱是指與 Managed 編譯程式所產生的 CIL 模組對應的 Managed PDB（例如 C# 或 Visual Basic 編譯程式）。 此 PDB 會使用 Managed PDB 格式，並描述原始 Managed 原始程式碼中的專案，例如檔案、行號和符號名稱，如何對應至編譯至 CIL 模組的 CIL 元素。

  • 以 "NativePdb" 開頭的欄位名稱表示該 NGen PDB 是透過呼叫 NGEN createPDB而產生。 這個 PDB 會使用受管理的 PDB 格式，並描述各個項目如何從原始的受管理來源程式碼 (例如檔案、行號和符號名稱) 對應至編譯成 NGen 模組的原生項目。

CLR 定義域模組事件

下表說明關鍵字和層級。

引發事件的關鍵字 活動 層級
LoaderKeyword (0x8) DomainModuleLoad_V1 告知性 (4)
LoaderRundownKeyword (0x8) +

StartRundownKeyword		 DomainModuleDCStart_V1 告知性 (4)
LoaderRundownKeyword (0x8) +

EndRundownKeyword		 DomainModuleDCEnd_V1 告知性 (4)

下表說明事件資訊。

活動 事件識別碼 描述
DomainModuleLoad_V1 151 針對應用程式定義域載入模組時引發。
DomainModuleDCStart_V1 151 在開始取消期間列舉針對應用程式定義域所載入的模組，並且針對所有應用程式定義域記錄。
DomainModuleDCEnd_V1 152 在結束取消期間列舉針對應用程式定義域所載入的模組，並且針對所有應用程式定義域記錄。

下表說明事件資料。

欄位名稱 資料類型 描述
ModuleID win:UInt64 識別這個模組所屬的組件。
AssemblyID win:UInt64 這個模組所在之組件的 ID。
AppDomainID win:UInt64 使用這個模組之應用程式定義域的 ID。
ModuleFlags win:UInt32 0x1：定義域中性模組。

0x2：模組具有原生映像。

0x4：動態模組。

0x8：資訊清單模組。
Reserved1 win:UInt32 保留的欄位。
ModuleILPath win:UnicodeString 模組的 CIL 映射路徑，如果它是動態元件，則為動態模組名稱（Null 終止）。
ModuleNativePath win:UnicodeString 模組原生映像的路徑 (如果存在的話 (以 Null 終止))。
ClrInstanceID win:UInt16 CLR 或 CoreCLR 執行個體的唯一 ID。

模組範圍事件

下表說明關鍵字和層級。

引發事件的關鍵字 活動 層級
PerfTrackKeyWord) ModuleRange 告知性 (4)
PerfTrackKeyWord ModuleRangeDCStart 告知性 (4)
PerfTrackKeyWord ModuleRangeDCEnd 告知性 (4)

下表說明事件資訊。

活動 事件識別碼 描述
ModuleRange 158 如果已載入的原生映像產生器 (NGen) 已使用 IBC 最佳化，就會出現這個事件，其中包含有關 NGen 映像作用範圍的資訊。
ModuleRangeDCStart 160 在開始取消期間引發的 ModuleRange 事件。
ModuleRangeDCEnd 161 在結束取消期間引發的 ModuleRange 事件。

下表說明事件資料。

欄位名稱 資料類型 描述
ClrInstanceID win:UInt16 載入 CLR 的多個執行個體時，可在處理序中唯一識別 CLR 的特定執行個體。
ModuleID win:UInt64 識別這個模組所屬的組件。
RangeBegin win:UInt32 模組中的位移，表示指定範圍類別的起始範圍。
RangeSize win:UInt32 指定範圍的大小 (以位元組為單位)。
RangeType win:UInt32 單一值 0x4，用來代表非作用 IBC 範圍。 此欄位在未來可以代表更多值。
RangeSize1 win:UInt32 0 表示不正確的資料。
RangeBegin2 win:UnicodeString

備註

如果 .NET Framework 處理序中載入的 NGen 影像已使用 IBC 最佳化，則包含 NGen 影像中作用範圍的 ModuleRange 事件會與其 moduleID 和 ClrInstanceID一起記錄。 如果 NGen 影像未經過 IBC 最佳化，則不會記錄這個事件。 若要判斷模組名稱，這個事件必須以模組載入 ETW 事件定序。

這個事件的承載大小是可變的， Count 欄位會指出事件中包含的範圍位移數。 這個事件必須以 Windows IStart 事件定序，以便判斷實際範圍。 每當載入影像時，就會記錄 Windows 影像載入事件，並且包含所載入影像的虛擬位址。

模組範圍事件會在任何 ETW 層級大於或等於 4 且分類為告知性事件時引發。

另請參閱