Parole chiave e livelli ETW di CLRCLR ETW Keywords and Levels

Gli eventi Event Tracing for Windows (ETW) possono essere filtrati in base a categoria e livello.Event tracing for Windows (ETW) events can be filtered by category and level. Le Parole chiave ETW di CLR degli eventi permettono di filtrare gli eventi per categoria e vengono usate in diverse combinazioni per i provider di runtime e rundown.Event CLR ETW Keywords enable the filtering of events by category; they are used in combinations for the runtime and rundown providers. I livelli evento vengono identificati da flag.The event levels are identified by flags.

Parole chiave ETW di CLRCLR ETW Keywords

Le parole chiave sono flag che possono essere combinati per generare valori.The keywords are flags that can be combined to generate values. In pratica, è possibile usare i valori esadecimali delle parole chiave invece dei nomi delle parole chiave quando si chiamano le utilità della riga di comando.In practice, you use the hexadecimal values of the keywords instead of the keyword names when you call the command-line utilities.

Le parole chiave vengono descritte nelle tabelle seguenti.The keywords are described in the following tables:

Parole chiave di runtime ETW di CLRCLR ETW Runtime Keywords

La tabella seguente contiene le parole chiave di runtime ETW di CLR, i rispettivi valori e informazioni sullo scopo per cui vengono usate.The following table lists the CLR ETW runtime keywords, their values, and what they are used for.

Nome parola chiave di runtimeRuntime keyword name ValoreValue ScopoPurpose
GCKeyword 0x000000010x00000001 Consente la raccolta di eventi di Garbage Collection.Enables the collection of garbage collection events.
LoaderKeyword 0x000000080x00000008 Consente la raccolta di eventi del caricatore.Enables the collection of loader events.
JITKeyword 0x000000100x00000010 Consente la raccolta di eventi JIT (Just-In-Time).Enables the collection of just-in-time (JIT) events.
NGenKeyword 0x000000200x00000020 Consente la raccolta di eventi per metodi delle immagini native (metodi elaborati dal generatore di immagini native, Ngen.exe). Viene usata con StartEnumerationKeyword e EndEnumerationKeyword.Enables the collection of events for native image methods (methods processed by the Native Image Generator, Ngen.exe); used with StartEnumerationKeyword and EndEnumerationKeyword. Questa parola chiave ha un overhead elevato.This keyword has high overhead. Genera eventi per ogni metodo incluso in ogni modulo NGen caricato.It generates events for every method inside every loaded NGen module. Se possibile, invece di usare questa parola chiave è consigliabile usare database di programma (PDB) generati da strumenti di profilatura che recuperano informazioni sui metodi dai moduli 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. Vedere anche OverrideAndSuppressNGenEventsKeyword più avanti in questa tabella.See also OverrideAndSuppressNGenEventsKeyword later in this table.
StartEnumerationKeyword 0x000000400x00000040 Consente l'enumerazione di tutti i metodi nel runtime. Viene usata in combinazione con NGenKeyword.Enables the enumeration of all the methods in the runtime; used in conjunction with NGenKeyword.
EndEnumerationKeyword 0x000000800x00000080 Consente l'enumerazione di tutti i metodi eliminati nel runtime. Viene usata in combinazione con JITKeyword e NGenKeyword.Enables the enumeration of all the methods destroyed in the runtime; used in conjunction with JITKeyword and NGenKeyword.
SecurityKeyword 0x000004000x00000400 Consente la raccolta di eventi di sicurezza.Enables the collection of security events.
AppDomainResourceManagementKeyword 0x000008000x00000800 Consente la raccolta di eventi di monitoraggio delle risorse a livello di dominio applicazione.Enables the collection of resource monitoring events at an application domain level.
JITTracingKeyword 0x000010000x00001000 Consente la raccolta di eventi di traccia JIT.Enables the collection of JIT tracing events.
InteropKeyword 0x000020000x00002000 Consente la raccolta di eventi di interoperabilità.Enables the collection of interop events.
ContentionKeyword 0x000040000x00004000 Consente la raccolta di eventi di conflitto.Enables the collection of contention events.
ExceptionKeyword 0x000080000x00008000 Consente la raccolta di eventi di eccezione.Enables the collection of exception events.
ThreadingKeyword 0x000100000x00010000 Consente la raccolta di eventi del pool di thread.Enables the collection of thread pool events.
OverrideAndSuppressNGenEventsKeyword 0x000400000x00040000 (Disponibile in .NET Framework 4.5.NET Framework 4.5 e versioni successive). Elimina la parola chiave NGenKeyword con overhead elevato e impedisce la generazione di eventi per i metodi inclusi nei moduli NGen.(Available in the .NET Framework 4.5.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 partire da .NET Framework 4.5.NET Framework 4.5, gli strumenti di profilatura devono usare OverrideAndSuppressNGenEventsKeyword e NGenKeyword insieme per eliminare la generazione di eventi per i metodi nei moduli NGen.Starting with the .NET Framework 4.5.NET Framework 4.5, profiling tools should use OverrideAndSuppressNGenEventsKeyword and NGenKeyword together to suppress the generation of events for methods in NGen modules. In questo modo, lo strumento di profilatura può usare i più efficienti PDB NGen per ottenere informazioni sui metodi nei moduli NGen.This enables the profiling tool to use the more efficient NGen PDBs to get information about methods in NGen modules. CLR in .NET Framework 4 e versioni precedenti non supporta la creazione di PDB NGen.The CLR in the .NET Framework 4 and earlier versions does not support the creation of NGen PDBs. In queste versioni precedenti CLR non riconosce OverrideAndSuppressNGenEventsKeyword ed elabora NGenKeyword per generare eventi per i metodi nei moduli 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 Consente la raccolta di eventi ModuleLoad e ModuleRange .Enables the collection of the ModuleLoad and ModuleRange events.
StackKeyword 0x400000000x40000000 Consente la raccolta di eventi di analisi dello stackdi CLR.Enables the collection of CLR stack trace events.

Torna all'inizioBack to top

Parole chiave di rundown ETW di CLRCLR ETW Rundown Keywords

La tabella seguente contiene le parole chiave di rundown ETW di CLR, i rispettivi valori e informazioni sullo scopo per cui vengono usate.The following table lists the CLR ETW rundown keywords, their values, and what they are used for.

Nome parola chiave di rundownRundown keyword name ValoreValue ScopoPurpose
LoaderRundownKeyword 0x000000080x00000008 Consente la raccolta di eventi del caricatore se usata con StartRundownKeyword e EndRundownKeyword.Enables the collection of loader events when used with StartRundownKeyword and EndRundownKeyword.
JitRundownKeyword 0x000000100x00000010 Consente la raccolta di eventi DCStart e DCEnd per metodi compilati tramite JIT se usata con StartRundownKeyword e EndRundownKeyword.Enables the collection of method DCStart and DCEnd events for JIT-compiled methods when used with StartRundownKeyword and EndRundownKeyword.
NGenRundownKeyword 0x000000200x00000020 Consente la raccolta di eventi DCStart e DCEnd per metodi delle immagini native NGen se usata con StartRundownKeyword e EndRundownKeyword.Enables the collection of method DCStart and DCEnd events for NGen native image methods when used with StartRundownKeyword and EndRundownKeyword. Questa parola chiave ha un overhead elevato.This keyword has high overhead. Genera eventi per ogni metodo incluso in ogni modulo NGen caricato.It generates events for every method inside every loaded NGen module. Se possibile, invece di usare questa parola chiave è consigliabile usare database di programma (PDB) generati da strumenti di profilatura che recuperano informazioni sui metodi dai moduli 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. Vedere anche OverrideAndSuppressNGenEventsRundownKeyword più avanti in questa tabella.See also OverrideAndSuppressNGenEventsRundownKeyword later in this table.
StartRundownKeyword 0x000000400x00000040 Consente l'enumerazione dello stato del sistema durante un rundown di avvio.Enables the enumeration of system state during a start rundown.
EndRundownKeyword 0x000001000x00000100 Consente l'enumerazione dello stato del sistema durante un rundown di fine.Enables the enumeration of system state during an end rundown.
AppDomainResourceManagementRundownKeyword 0x000008000x00000800 Consente la raccolta di eventi per il monitoraggio delle risorse a livello di AppDomain se usata con StartRundownKeyword o EndRundownKeyword.Enables the collection of events for resource monitoring at an AppDomain level when used with StartRundownKeyword or EndRundownKeyword.
ThreadingKeyword 0x000100000x00010000 Consente la raccolta di eventi del pool di thread.Enables the collection of thread pool events.
OverrideAndSuppressNGenEventsRundownKeyword 0x000400000x00040000 Disponibile in .NET Framework 4.5.NET Framework 4.5 e versioni successive. Elimina la parola chiave NGenRundownKeyword con overhead elevato e impedisce la generazione di eventi per i metodi inclusi nei moduli NGen.(Available in the .NET Framework 4.5.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 partire da .NET Framework 4.5.NET Framework 4.5, gli strumenti di profilatura devono usare OverrideAndSuppressNGenEventsRundownKeyword e NGenRundownKeyword insieme per eliminare la generazione di eventi per i metodi nei moduli NGen.Starting with the .NET Framework 4.5.NET Framework 4.5, profiling tools should use OverrideAndSuppressNGenEventsRundownKeyword and NGenRundownKeyword together to suppress the generation of events for methods in NGen modules. In questo modo, lo strumento di profilatura può usare i più efficienti PDB NGen per ottenere informazioni sui metodi nei moduli NGen.This enables the profiling tool to use the more efficient NGen PDBs to get information about methods in NGen modules. CLR in .NET Framework 4 e versioni precedenti non supporta la creazione di PDB NGen.The CLR in the .NET Framework 4 and earlier versions does not support the creation of NGen PDBs. In queste versioni precedenti CLR non riconosce OverrideAndSuppressNGenEventsRundownKeyword ed elabora NGenRundownKeyword per generare eventi per i metodi nei moduli 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 Consente la raccolta degli eventi ModuleDCStart, ModuleDCEnd, ModuleRangeDCStarte ModuleRangeDCEnd .Enables the collection of the ModuleDCStart, ModuleDCEnd, ModuleRangeDCStart, and ModuleRangeDCEnd events.

Torna all'inizioBack to top

Combinazioni di parole chiave per la risoluzione dei simboli per il provider di runtimeKeyword Combinations for Symbol Resolution for the Runtime Provider

Parole chiave e flagKeywords and flags Eventi di caricamento/scaricamento di domini applicazione, assembly e moduliApplication domain, assembly, module load/unload events Eventi di caricamento/scaricamento di metodi (tranne gli eventi dinamici)Method load/unload events (except dynamic events) Eventi dinamici di caricamento/eliminazione di metodiDynamic method load/destroy events
LoaderKeyword Eventi di caricamento e scaricamento di moduli.Load and unload events. Nessuno.None. Nessuno.None.
JITKeyword

(+ StartEnumerationKeyword non aggiunge nulla)(+ StartEnumerationKeyword does not add anything)
Nessuno.None. Eventi di caricamento.Load events. Eventi di caricamento e scaricamento di moduli.Load and unload events.
JITKeyword +

EndEnumerationKeyword
Nessuno.None. Eventi di caricamento e scaricamento di moduli.Load and unload events. Eventi di caricamento e scaricamento di moduli.Load and unload events.
NGenKeyword Nessuno.None. Nessuno.None. Non applicabile.Not applicable.
NGenKeyword +

StartEnumerationKeyword
Nessuno.None. Eventi di caricamento.Load events. Non applicabile.Not applicable.
NGenKeyword +

EndEnumerationKeyword
Nessuno.None. Eventi di scaricamento.Unload events. Non applicabile.Not applicable.

Torna all'inizioBack to top

Combinazioni di parole chiave per la risoluzione dei simboli per il provider di rundownKeyword Combinations for Symbol Resolution for the Rundown Provider

Parole chiave e flagKeywords and flags Eventi DCStart/DCEnd di domini applicazione, assembly e moduliApplication domain, assembly, module DCStart/DCEnd events Eventi DCStart/DCEnd di metodi (inclusi gli eventi di metodi dinamici)Method DCStart/DCEnd events (including dynamic method events)
LoaderRundownKeyword +

StartRundownKeyword
EventiDCStart .DCStart events. Nessuno.None.
LoaderRundownKeyword +

EndRundownKeyword
EventiDCEnd .DCEnd events. Nessuno.None.
JITKeyword +

StartRundownKeyword
Nessuno.None. EventiDCStart .DCStart events.
JITKeyword +

EndRundownKeyword
Nessuno.None. EventiDCEnd .DCEnd events.
NGenKeyword +

StartRundownKeyword
Nessuno.None. EventiDCStart .DCStart events.
NGenKeyword +

EndRundownKeyword
Nessuno.None. EventiDCEnd .DCEnd events.

Torna all'inizioBack to top

Livelli evento ETWETW Event Levels

Gli eventi ETW possono essere filtrati in base al livello.ETW events can also be filtered by level. Se il livello è impostato su 0x5, vengono generati gli eventi di tutti i livelli, inclusi il livello 0x5 e quelli inferiori (ovvero gli eventi che appartengono alle categorie abilitate tramite le parole chiave).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. Se il livello è impostato su 0x2, vengono generati solo gli eventi che appartengono al livello 0x2 e a quelli inferiori.If the level is set at 0x2, only events that belong to level 0x2 and below are raised.

I livelli hanno i significati seguenti:The levels have the following meanings:

0x5 - Dettagliato0x5 - Verbose

0x4 - Informativo0x4 - Informational

0x3 - Avviso0x3 - Warning

0x2 - Errore0x2 - Error

0x1 - Critico0x1 - Critical

0x0 - LogAlways0x0 - LogAlways

Vedere ancheSee Also

Provider ETW di CLRCLR ETW Providers
Eventi ETW di CLRCLR ETW Events
Eventi ETW in Common Language RuntimeETW Events in the Common Language Runtime