Ключевые слова и уровни среды CLR (трассировка событий Windows)
Трассировку событий для событий ETW можно отфильтровать по категории и уровню. Ключевые слова событийКлючевые слова ETW среды CLR обеспечивают фильтрацию событий по категории; они используются в комбинациях для поставщиков среды выполнения и очистки. Уровни событий определяются флагами.
Ключевые слова ETW среды CLR
Ключевые слова служат флагами, которые можно объединять для формирования значений. На практике при использовании программ командной строки вместо имен ключевых слов применяются их шестнадцатеричные значения.
В следующих таблицах представлено описание ключевых слов.
Ключевые слова среды выполнения трассировки событий ETW в среде CLR
Ключевые слова среды очистки трассировки событий ETW в среде CLR
Комбинации ключевых слов для разрешения символов для поставщика среды выполнения
Комбинации ключевых слов для разрешения символов для поставщика очистки
Ключевые слова среды выполнения трассировки событий ETW в среде CLR
В следующей таблице приведены ключевые слова времени выполнения ETW среды CLR, их значения и предназначение.
Имя ключевого слова времени выполнения |
Значение |
Назначение |
|---|---|---|
GCKeyword |
0x00000001 |
Включает сбор событий сборки мусора. |
LoaderKeyword |
0x00000008 |
Включает сбор событий загрузчика. |
JITKeyword |
0x00000010 |
Включает сбор JIT-событий. |
NGenKeyword |
0x00000020 |
Включает сбор событий для методов образов в машинном коде (методы, обрабатываемые инструментом для создания машинных образов (Ngen.exe)), используются с ключевыми словами StartEnumerationKeyword и EndEnumerationKeyword. |
StartEnumerationKeyword |
0x00000040 |
Включает перечисление всех методов во время выполнения, используется вместе с NGenKeyword. |
EndEnumerationKeyword |
0x00000080 |
Включает перечисление всех методов, разрушенных во время выполнения, используется вместе с JITKeyword и NGenKeyword. |
SecurityKeyword |
0x00000400 |
Включает сбор событий безопасности. |
AppDomainResourceManagementKeyword |
0x00000800 |
Включает сбор событий отслеживания ресурсов на уровне домена приложения. |
JITTracingKeyword |
0x00001000 |
Включает сбор событий трассировки JIT-компилятора. |
InteropKeyword |
0x00002000 |
Включает сбор событий взаимодействия. |
ContentionKeyword |
0x00004000 |
Включает сбор событий конфликтов. |
ExceptionKeyword |
0x00008000 |
Включает сбор событий исключений. |
ThreadingKeyword |
0x00010000 |
Включает сбор событий пула потоков. |
StackKeyword |
0x40000000 |
Включает сбор событий трассировки стека среды CLR. |
К началу
Ключевые слова среды очистки трассировки событий ETW в среде CLR
В следующей таблице приведены ключевые слова очистки ETW среды CLR, их значения и предназначение.
Имя ключевого слова очистки |
Значение |
Назначение |
|---|---|---|
LoaderRundownKeyword |
0x00000008 |
Включает сбор событий загрузчика при использовании с ключевыми словами StartRundownKeyword и EndRundownKeyword. |
JitRundownKeyword |
0x00000010 |
Включает сбор событий DCStart и DCEnd методов (скомпилированных JIT-компилятором) при использовании с ключевыми словами StartRundownKeyword и EndRundownKeyword. |
NGenRundownKeyword |
0x00000020 |
Включает сбор событий DCStart и DCEnd для методов образов NGEN в машинном коде при использовании с ключевыми словами StartRundownKeyword и EndRundownKeyword. |
StartRundownKeyword |
0x00000040 |
Включает перечисление состояния системы во время очистки запуска. |
EndRundownKeyword |
0x00000100 |
Включает перечисление состояния системы во время очистки окончания. |
AppDomainResourceManagementRundownKeyword |
0x00000800 |
Включает сбор событий для отслеживания ресурсов на уровне AppDomain при использовании с ключевыми словами StartRundownKeyword или EndRundownKeyword. |
К началу
Комбинации ключевых слов для разрешения символов для поставщика среды выполнения
Ключевые слова и флаги |
События загрузки/выгрузки доменов приложений, сборок, модулей |
События загрузки/выгрузки методов (кроме динамических событий) |
Динамические события загрузки/разрушения методов |
|---|---|---|---|
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 — Verbose (подробный);
0x4 — Informational (информационный);
0x3 — Warning (предупреждение);
0x2 — Error (ошибка);
0x1 — Critical (критический);
0x0 — LogAlways (регистрировать всегда).
К началу
См. также
Основные понятия
События трассировки событий Windows в среде CLR