Palabras clave y niveles ETW de CLRCLR ETW Keywords and Levels

El Seguimiento de eventos para Windows (ETW) se puede filtrar por categoría y nivel.Event tracing for Windows (ETW) events can be filtered by category and level. Las Palabras clave ETW de CLR de evento permiten el filtrado de eventos por categoría; se usan en combinaciones para los proveedores de tiempo de ejecución y detención.Event CLR ETW Keywords enable the filtering of events by category; they are used in combinations for the runtime and rundown providers. Los niveles de evento se identifican mediante marcas.The event levels are identified by flags.

Palabras clave ETW de CLRCLR ETW Keywords

Las palabras clave son marcas que se pueden combinar para generar valores.The keywords are flags that can be combined to generate values. En la práctica, cuando se llama a las utilidades de línea de comandos, se usan los valores hexadecimales de las palabras clave en lugar de los nombres de palabra clave.In practice, you use the hexadecimal values of the keywords instead of the keyword names when you call the command-line utilities.

Las palabras clave se describen en la tabla siguiente.The keywords are described in the following tables:

Palabras clave de runtime de ETW de CLRCLR ETW Runtime Keywords

En la tabla siguiente se enumeran las palabras clave de runtime de ETW de CLR, sus valores y se explica para qué se usan.The following table lists the CLR ETW runtime keywords, their values, and what they are used for.

Nombre de la palabra clave de runtimeRuntime keyword name {2>Value<2}Value FinalidadPurpose
GCKeyword 0x000000010x00000001 Habilita la recopilación de eventos de recolección de elementos no utilizados.Enables the collection of garbage collection events.
LoaderKeyword 0x000000080x00000008 Habilita la recopilación de eventos de cargador.Enables the collection of loader events.
JITKeyword 0x000000100x00000010 Habilita la recopilación de eventos Just-In-Time (JIT).Enables the collection of just-in-time (JIT) events.
NGenKeyword 0x000000200x00000020 Habilita la recopilación de eventos para los métodos de imágenes nativas (métodos procesados por el generador de imágenes nativas, Ngen.exe); se usa con StartEnumerationKeyword y EndEnumerationKeyword.Enables the collection of events for native image methods (methods processed by the Native Image Generator, Ngen.exe); used with StartEnumerationKeyword and EndEnumerationKeyword. Esta palabra clave tiene una gran sobrecarga.This keyword has high overhead. Genera eventos para todos los métodos que se encuentran en los módulos cargados de NGen.It generates events for every method inside every loaded NGen module. Siempre que sea posible, en lugar de usar esta palabra clave, le recomendamos que use las bases de datos de programa (PDB) generadas por herramientas de generación de perfiles para recuperar información acerca de los métodos de los módulos NGen.Whenever possible, instead of using this keyword, we recommend that you use the program databases (PDBs) generated by profiling tools to retrieve information about methods from NGen modules. Vea también OverrideAndSuppressNGenEventsKeyword más adelante en esta tabla.See also OverrideAndSuppressNGenEventsKeyword later in this table.
StartEnumerationKeyword 0x000000400x00000040 Habilita la enumeración de todos los métodos en runtime; se usa junto con NGenKeyword.Enables the enumeration of all the methods in the runtime; used in conjunction with NGenKeyword.
EndEnumerationKeyword 0x000000800x00000080 Habilita la enumeración de todos los métodos destruidos en runtime; se usa junto con JITKeyword y NGenKeyword.Enables the enumeration of all the methods destroyed in the runtime; used in conjunction with JITKeyword and NGenKeyword.
SecurityKeyword 0x000004000x00000400 Habilita la recopilación de eventos de seguridad.Enables the collection of security events.
AppDomainResourceManagementKeyword 0x000008000x00000800 Habilita la recopilación de eventos de supervisión de recursos en un nivel de dominio de aplicación.Enables the collection of resource monitoring events at an application domain level.
JITTracingKeyword 0x000010000x00001000 Habilita la recopilación de eventos de seguimiento JIT.Enables the collection of JIT tracing events.
InteropKeyword 0x000020000x00002000 Habilita la recopilación de eventos de interoperabilidad.Enables the collection of interop events.
ContentionKeyword 0x000040000x00004000 Habilita la recopilación de eventos de contención.Enables the collection of contention events.
ExceptionKeyword 0x000080000x00008000 Habilita la recopilación de eventos de excepción.Enables the collection of exception events.
ThreadingKeyword 0x000100000x00010000 Habilita la recopilación de eventos de grupo de subprocesos.Enables the collection of thread pool events.
OverrideAndSuppressNGenEventsKeyword 0x000400000x00040000 (Disponible en el .NET Framework 4,5 y versiones posteriores). Suprime la palabra clave de NGenKeyword de sobrecarga alta y evita la generación de eventos para los métodos que están dentro de los módulos NGen.(Available in the .NET Framework 4.5 and later.) Suppresses the high-overhead NGenKeyword keyword and prevents the generation of events for methods that are inside NGen modules. A partir del .NET Framework 4,5, las herramientas de generación de perfiles deben usar OverrideAndSuppressNGenEventsKeyword y NGenKeyword juntas para suprimir la generación de eventos para los métodos de los módulos NGen.Starting with the .NET Framework 4.5, profiling tools should use OverrideAndSuppressNGenEventsKeyword and NGenKeyword together to suppress the generation of events for methods in NGen modules. Esto permite que la herramienta de generación de perfiles use de forma más eficaz los archivos PDB de NGen para obtener información sobre los métodos de módulos NGen.This enables the profiling tool to use the more efficient NGen PDBs to get information about methods in NGen modules. En .NET Framework 4 y versiones anteriores, el CLR no admite la creación de archivos PDB de NGen.The CLR in the .NET Framework 4 and earlier versions does not support the creation of NGen PDBs. En estas versiones anteriores, el CLR no reconocerá OverrideAndSuppressNGenEventsKeyword y procesará NGenKeyword para generar eventos para los métodos de módulos NGen.In these earlier versions, the CLR will not recognize OverrideAndSuppressNGenEventsKeyword and will process NGenKeyword to generate events for methods in NGen modules.
PerfTrackKeyWord 0x20000000x2000000 Habilita la recopilación de eventos ModuleLoad y ModuleRange .Enables the collection of the ModuleLoad and ModuleRange events.
StackKeyword 0x400000000x40000000 Habilita la recopilación de eventos de seguimiento de pilade CLR.Enables the collection of CLR stack trace events.

Palabras clave de detención de ETW de CLRCLR ETW Rundown Keywords

En la tabla siguiente se enumeran las palabras clave de detención de ETW de CLR, sus valores y se explica para qué se usan.The following table lists the CLR ETW rundown keywords, their values, and what they are used for.

Nombre de la palabra clave de detenciónRundown keyword name {2>Value<2}Value FinalidadPurpose
LoaderRundownKeyword 0x000000080x00000008 Habilita la recopilación de eventos de cargador cuando se usa con StartRundownKeyword y EndRundownKeyword.Enables the collection of loader events when used with StartRundownKeyword and EndRundownKeyword.
JitRundownKeyword 0x000000100x00000010 Habilita la recopilación de eventos de método DCStart y DCEnd para métodos compilados JIT cuando se usa con StartRundownKeyword y EndRundownKeyword.Enables the collection of method DCStart and DCEnd events for JIT-compiled methods when used with StartRundownKeyword and EndRundownKeyword.
NGenRundownKeyword 0x000000200x00000020 Habilita la recopilación de eventos de método DCStart y DCEnd para métodos de imágenes nativas de NGen cuando se usa con StartRundownKeyword y EndRundownKeyword.Enables the collection of method DCStart and DCEnd events for NGen native image methods when used with StartRundownKeyword and EndRundownKeyword. Esta palabra clave tiene una gran sobrecarga.This keyword has high overhead. Genera eventos para todos los métodos que se encuentran en los módulos cargados de NGen.It generates events for every method inside every loaded NGen module. Siempre que sea posible, en lugar de usar esta palabra clave, le recomendamos que use las bases de datos de programa (PDB) generadas por herramientas de generación de perfiles para recuperar información acerca de los métodos de los módulos NGen.Whenever possible, instead of using this keyword, we recommend that you use the program databases (PDBs) generated by profiling tools to retrieve information about methods from NGen modules. Vea también OverrideAndSuppressNGenEventsRundownKeyword más adelante en esta tabla.See also OverrideAndSuppressNGenEventsRundownKeyword later in this table.
StartRundownKeyword 0x000000400x00000040 Habilita la enumeración del estado del sistema durante una detención de inicio.Enables the enumeration of system state during a start rundown.
EndRundownKeyword 0x000001000x00000100 Habilita la enumeración del estado del sistema durante una detención de final.Enables the enumeration of system state during an end rundown.
AppDomainResourceManagementRundownKeyword 0x000008000x00000800 Habilita la recopilación de eventos de supervisión de recursos en un nivel de AppDomain cuando se usa con StartRundownKeyword o EndRundownKeyword.Enables the collection of events for resource monitoring at an AppDomain level when used with StartRundownKeyword or EndRundownKeyword.
ThreadingKeyword 0x000100000x00010000 Habilita la recopilación de eventos de grupo de subprocesos.Enables the collection of thread pool events.
OverrideAndSuppressNGenEventsRundownKeyword 0x000400000x00040000 (Disponible en el .NET Framework 4,5 y versiones posteriores). Suprime la palabra clave de NGenRundownKeyword de sobrecarga alta y evita la generación de eventos para los métodos que están dentro de los módulos NGen.(Available in the .NET Framework 4.5 and later.) Suppresses the high-overhead NGenRundownKeyword keyword and prevents the generation of events for methods that are inside NGen modules. A partir del .NET Framework 4,5, las herramientas de generación de perfiles deben usar OverrideAndSuppressNGenEventsRundownKeyword y NGenRundownKeyword juntas para suprimir la generación de eventos para los métodos de los módulos NGen.Starting with the .NET Framework 4.5, profiling tools should use OverrideAndSuppressNGenEventsRundownKeyword and NGenRundownKeyword together to suppress the generation of events for methods in NGen modules. Esto permite que la herramienta de generación de perfiles use de forma más eficaz los archivos PDB de NGen para obtener información sobre los métodos de módulos NGen.This enables the profiling tool to use the more efficient NGen PDBs to get information about methods in NGen modules. En .NET Framework 4 y versiones anteriores, el CLR no admite la creación de archivos PDB de NGen.The CLR in the .NET Framework 4 and earlier versions does not support the creation of NGen PDBs. En estas versiones anteriores, el CLR no reconocerá OverrideAndSuppressNGenEventsRundownKeyword y procesará NGenRundownKeyword para generar eventos para los métodos de módulos NGen.In these earlier versions, the CLR will not recognize OverrideAndSuppressNGenEventsRundownKeyword and will process NGenRundownKeyword to generate events for methods in NGen modules.
PerfTrackKeyWord 0x20000000x2000000 Habilita la recopilación de eventos ModuleDCStart, ModuleDCEnd, ModuleRangeDCStarty ModuleRangeDCEnd .Enables the collection of the ModuleDCStart, ModuleDCEnd, ModuleRangeDCStart, and ModuleRangeDCEnd events.

Combinaciones de palabras clave para la resolución de símbolos para el proveedor de runtimeKeyword Combinations for Symbol Resolution for the Runtime Provider

Palabras clave y marcasKeywords and flags Dominio de aplicación, ensamblado, eventos de carga/descarga de módulosApplication domain, assembly, module load/unload events Eventos de carga/descarga de método (excepto eventos dinámicos)Method load/unload events (except dynamic events) Eventos de carga/destrucción de métodos dinámicosDynamic method load/destroy events
LoaderKeyword Eventos de carga y descarga.Load and unload events. Ninguna.None. Ninguna.None.
JITKeyword

(+ StartEnumerationKeyword no agrega nada)(+ StartEnumerationKeyword does not add anything)
Ninguna.None. Eventos de carga.Load events. Eventos de carga y descarga.Load and unload events.
JITKeyword +

EndEnumerationKeyword
Ninguna.None. Eventos de carga y descarga.Load and unload events. Eventos de carga y descarga.Load and unload events.
NGenKeyword Ninguna.None. Ninguna.None. No es aplicable.Not applicable.
NGenKeyword +

StartEnumerationKeyword
Ninguna.None. Eventos de carga.Load events. No es aplicable.Not applicable.
NGenKeyword +

EndEnumerationKeyword
Ninguna.None. Eventos de descarga.Unload events. No es aplicable.Not applicable.

Combinaciones de palabras clave para la resolución de símbolos para el proveedor de detenciónKeyword Combinations for Symbol Resolution for the Rundown Provider

Palabras clave y marcasKeywords and flags Dominio de aplicación, ensamblado, eventos DCStart/DCEnd de módulosApplication domain, assembly, module DCStart/DCEnd events Eventos DCStart/DCEnd de método (incluidos los eventos de métodos dinámicos)Method DCStart/DCEnd events (including dynamic method events)
LoaderRundownKeyword +

StartRundownKeyword
EventosDCStart .DCStart events. Ninguna.None.
LoaderRundownKeyword +

EndRundownKeyword
EventosDCEnd .DCEnd events. Ninguna.None.
JITKeyword +

StartRundownKeyword
Ninguna.None. EventosDCStart .DCStart events.
JITKeyword +

EndRundownKeyword
Ninguna.None. EventosDCEnd .DCEnd events.
NGenKeyword +

StartRundownKeyword
Ninguna.None. EventosDCStart .DCStart events.
NGenKeyword +

EndRundownKeyword
Ninguna.None. EventosDCEnd .DCEnd events.

Niveles de eventos ETWETW Event Levels

Los eventos ETW también se pueden filtrar por nivel.ETW events can also be filtered by level. Si el nivel se establece en 0x5, se generan eventos de todos los niveles, incluidos 0 x 5 e inferiores (que son eventos que pertenecen a las categorías habilitadas mediante palabras clave).If the level is set at 0x5, events of all levels, including 0x5 and below (which are events that belong to categories enabled through keywords) are raised. Si el nivel se establece en 0x2, tan solo se producen los eventos que pertenecen al nivel 0x2 e inferiores.If the level is set at 0x2, only events that belong to level 0x2 and below are raised.

Los niveles tienen los significados siguientes:The levels have the following meanings:

0x5: Verbose0x5 - Verbose

0x4: Informativo0x4 - Informational

0x3: Advertencia0x3 - Warning

0x2: Error0x2 - Error

0x1: Crítico0x1 - Critical

0x0: LogAlways0x0 - LogAlways

Vea tambiénSee also