Поделиться через


События загрузчика (трассировка событий Windows)

Эти события собирают информацию, относящуюся к загрузке и выгрузке доменов приложений, сборок и модулей.

Все события загрузчика создаются при использовании ключевого слова LoaderKeyword (0x8). События DCStart и DCEnd создаются при использовании ключевого слова LoaderRundownKeyword (0x8) с включенным ключевым словом StartRundown/EndRundown. (Дополнительные сведения см. в разделе Ключевые слова и уровни среды CLR (трассировка событий Windows).)

События загрузчика делятся на следующие категории.

  • События домена приложений

  • События сборки загрузчика среды CLR

  • События модулей

  • События модулей домена среды CLR

События домена приложений

В следующей таблице показаны ключевое слово и уровень.

Ключевое слово для вызова события

Событие

Уровень

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.

К началу

События сборки загрузчика среды 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

Уникальный идентификатор сборки.

AppDomainID

win:UInt64

Идентификатор домена этой сборки.

BindingID

win:UInt64

Идентификатор, уникальным образом определяющий привязку сборки.

AssemblyFlags

win:UInt32

0x1: сборка, не зависящая от домена.

0x2: динамическая сборка.

0x4: сборка с образом неуправляемого кода.

0x8: собираемая сборка.

AssemblyName

win:UnicodeString

Полное имя сборки.

ClrInstanceID

win:UInt16

Уникальный идентификатор экземпляра среды CLR или CoreCLR.

К началу

События модулей

В следующей таблице показаны ключевое слово и уровень.

Ключевое слово для вызова события

Событие

Уровень

LoaderKeyword (0x8)

ModuleLoad_V1 и ModuleUnload_V1

Информационный (4)

LoaderRundownKeyword (0x8) +

StartRundownKeyword

ModuleDCStart_V1

Информационный (4)

LoaderRundownKeyword (0x8) +

EndRundownKeyword

ModuleDCEnd_V1

Информационный (4)

В следующей таблице приведены сведения о событии.

Событие

Идентификатор события

Описание

ModuleLoad_V1

152

Вызывается при загрузке модуля в течение срока существования процесса.

ModuleUnload_V1

153

Вызывается при выгрузке модуля в течение срока существования процесса.

ModuleDCStart_V1

153

Перечисляет модули во время очистки запуска.

ModuleDCEnd_V1

154

Перечисляет модули во время очистки окончания.

В следующей таблице приведены сведения о событии.

Имя поля

Тип данных

Описание

ModuleID

win:UInt64

Уникальный идентификатор модуля.

AssemblyID

win:UInt64

Идентификатор сборки, в которой находится этот модуль.

ModuleFlags

win:UInt32

0x1: модуль, не зависящий от домена.

0x2: модуль с образом неуправляемого кода.

0x4: динамический модуль.

0x8: модуль манифеста.

Reserved1

win:UInt32

Зарезервированное поле.

ModuleILPath

win:UnicodeString

Путь образа языка MSIL для модуля или имя динамического модуля, если это динамическая сборка (строка, заканчивающаяся нулем).

ModuleNativePath

win:UnicodeString

Путь к образу машинного кода для модуля, если существует (строка, заканчивающаяся нулем).

ClrInstanceID

win:UInt16

Уникальный идентификатор экземпляра среды CLR или CoreCLR.

К началу

События модулей домена среды 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

Идентификатор сборки, в которой находится этот модуль.

AppDomainID

win:UInt64

Идентификатор домена приложения, в котором используется этот модуль.

ModuleFlags

win:UInt32

0x1: модуль, не зависящий от домена.

0x2: модуль с образом неуправляемого кода.

0x4: динамический модуль.

0x8: модуль манифеста.

Reserved1

win:UInt32

Зарезервированное поле.

ModuleILPath

win:UnicodeString

Путь к образу MSIL для домена или имя динамического модуля, если это динамическая сборка (строка, заканчивающаяся нулем).

ModuleNativePath

win:UnicodeString

Путь к образу машинного кода для модуля, если существует (строка, заканчивающаяся нулем).

ClrInstanceID

win:UInt16

Уникальный идентификатор экземпляра среды CLR или CoreCLR.

К началу

См. также

Основные понятия

События трассировки событий Windows в среде CLR