Delen via

CLR ETW-trefwoorden en -niveaus

  • Artikel

Gebeurtenistracering voor Windows-gebeurtenissen (ETW) kan worden gefilterd op categorie en niveau. Event CLR ETW Trefwoorden maken het filteren van gebeurtenissen op categorie mogelijk; ze worden gebruikt in combinaties voor de runtime- en rundown-providers. De gebeurtenisniveaus worden aangeduid met vlaggen.

CLR ETW-trefwoorden

De trefwoorden zijn vlaggen die kunnen worden gecombineerd om waarden te genereren. In de praktijk gebruikt u de hexadecimale waarden van de trefwoorden in plaats van de namen van trefwoorden wanneer u de opdrachtregelprogramma's aanroept.

De trefwoorden worden beschreven in de volgende tabellen:

CLR ETW Runtime-trefwoorden

De volgende tabel bevat de CLR ETW-runtimetrefwoorden, hun waarden en waarvoor ze worden gebruikt.

Naam van runtime-trefwoord Waarde Doel
GCKeyword 0x00000001 Hiermee schakelt u het verzamelen van garbagecollection-gebeurtenissen in.
LoaderKeyword 0x00000008 Hiermee schakelt u het verzamelen van laadprogramma-gebeurtenissen in.
JITKeyword 0x00000010 Hiermee schakelt u het verzamelen van JIT-gebeurtenissen (Just-In-Time) in.
NGenKeyword 0x00000020 Hiermee schakelt u het verzamelen van gebeurtenissen voor systeemeigen installatiekopieënmethoden in (methoden die worden verwerkt door de Native Image Generator, Ngen.exe); gebruikt met StartEnumerationKeyword en EndEnumerationKeyword. Dit trefwoord heeft een hoge overhead. Er worden gebeurtenissen gegenereerd voor elke methode in elke geladen NGen-module. Waar mogelijk raden we u aan om, in plaats van dit trefwoord, de programmadatabases (PDB's) te gebruiken die zijn gegenereerd door profileringsprogramma's om informatie over methoden op te halen uit NGen-modules. Zie ook OverrideAndSuppressNGenEventsKeyword verderop in deze tabel.
StartEnumerationKeyword 0x00000040 Hiermee schakelt u de opsomming van alle methoden in de runtime in; gebruikt in combinatie met NGenKeyword.
EndEnumerationKeyword 0x00000080 Maakt de inventarisatie mogelijk van alle methoden die in de runtime zijn vernietigd; gebruikt in combinatie met JITKeyword en NGenKeyword.
SecurityKeyword 0x00000400 Hiermee schakelt u het verzamelen van beveiligingsevenementen in.
AppDomainResourceManagementKeyword 0x00000800 Hiermee schakelt u het verzamelen van gebeurtenissen voor resourcebewaking op het niveau van een toepassingsdomein in.
JITTracingKeyword 0x00001000 Hiermee schakelt u het verzamelen van JIT-traceringsevenementen in.
InteropKeyword 0x00002000 Hiermee schakelt u het verzamelen van interop-gebeurtenissen in.
ContentionKeyword 0x00004000 Hiermee schakelt u het verzamelen van conflict gebeurtenissen in.
ExceptionKeyword 0x00008000 Hiermee schakelt u het verzamelen van uitzonderingsevenementen in.
ThreadingKeyword 0x00010000 Hiermee schakelt u het verzamelen van threadpoolgebeurtenissen in.
OverrideAndSuppressNGenEventsKeyword 0x00040000 (Beschikbaar in de .NET Framework 4.5 en hoger.) Onderdrukt het trefwoord met hoge overhead NGenKeyword en voorkomt het genereren van gebeurtenissen voor methoden die zich in NGen-modules bevinden. Vanaf .NET Framework 4.5 moeten profileringshulpprogramma's en samen gebruiken OverrideAndSuppressNGenEventsKeywordNGenKeyword om het genereren van gebeurtenissen voor methoden in NGen-modules te onderdrukken. Hierdoor kan het profileringsprogramma de efficiëntere NGen-PDB's gebruiken om informatie op te halen over methoden in NGen-modules. De CLR in de .NET Framework 4 en eerdere versies biedt geen ondersteuning voor het maken van NGen-PDB's. In deze eerdere versies wordt de CLR niet herkend OverrideAndSuppressNGenEventsKeyword en verwerkt NGenKeyword om gebeurtenissen te genereren voor methoden in NGen-modules.
PerfTrackKeyWord 0x2000000 Hiermee schakelt u de verzameling van de ModuleLoad gebeurtenissen en ModuleRange in.
StackKeyword 0x40000000 Hiermee schakelt u het verzamelen van CLR-stacktraceringsevenementen in.

CLR ETW Rundown Trefwoorden

De volgende tabel bevat de CLR ETW-rundowntrefwoorden, hun waarden en waarvoor ze worden gebruikt.

Naam van rundown-trefwoord Waarde Doel
LoaderRundownKeyword 0x00000008 Hiermee schakelt u het verzamelen van laadprogramma-gebeurtenissen in wanneer deze worden gebruikt met StartRundownKeyword en EndRundownKeyword.
JitRundownKeyword 0x00000010 Hiermee kunt u de methode DCStart en DCEnd gebeurtenissen voor gecompileerde JIT-methoden verzamelen wanneer deze worden gebruikt met StartRundownKeyword en EndRundownKeyword.
NGenRundownKeyword 0x00000020 Hiermee schakelt u het verzamelen van methoden DCStart en DCEnd gebeurtenissen voor systeemeigen NGen-installatiekopieën in bij gebruik met StartRundownKeyword en EndRundownKeyword. Dit trefwoord heeft een hoge overhead. Er worden gebeurtenissen gegenereerd voor elke methode in elke geladen NGen-module. Waar mogelijk raden we u aan om, in plaats van dit trefwoord, de programmadatabases (PDB's) te gebruiken die zijn gegenereerd door profileringsprogramma's om informatie over methoden op te halen uit NGen-modules. Zie ook OverrideAndSuppressNGenEventsRundownKeyword verderop in deze tabel.
StartRundownKeyword 0x00000040 Hiermee schakelt u de opsomming van de systeemstatus in tijdens een startrundown.
EndRundownKeyword 0x00000100 Hiermee schakelt u de opsomming van de systeemstatus in tijdens een einderundown.
AppDomainResourceManagementRundownKeyword 0x00000800 Hiermee schakelt u het verzamelen van gebeurtenissen voor resourcebewaking op een AppDomain niveau in bij gebruik met StartRundownKeyword of EndRundownKeyword.
ThreadingKeyword 0x00010000 Hiermee schakelt u het verzamelen van threadpoolgebeurtenissen in.
OverrideAndSuppressNGenEventsRundownKeyword 0x00040000 (Beschikbaar in de .NET Framework 4.5 en hoger.) Onderdrukt het trefwoord met hoge overhead NGenRundownKeyword en voorkomt het genereren van gebeurtenissen voor methoden die zich in NGen-modules bevinden. Vanaf .NET Framework 4.5 moeten profileringshulpprogramma's en samen gebruiken OverrideAndSuppressNGenEventsRundownKeywordNGenRundownKeyword om het genereren van gebeurtenissen voor methoden in NGen-modules te onderdrukken. Hierdoor kan het profileringsprogramma de efficiëntere NGen-PDB's gebruiken om informatie op te halen over methoden in NGen-modules. De CLR in de .NET Framework 4 en eerdere versies biedt geen ondersteuning voor het maken van NGen-PDB's. In deze eerdere versies wordt de CLR niet herkend OverrideAndSuppressNGenEventsRundownKeyword en verwerkt NGenRundownKeyword om gebeurtenissen te genereren voor methoden in NGen-modules.
PerfTrackKeyWord 0x2000000 Hiermee schakelt u de verzameling van de ModuleDCStartgebeurtenissen , ModuleDCEnd, ModuleRangeDCStarten ModuleRangeDCEnd in.

Trefwoordcombinaties voor symboolomzetting voor de runtimeprovider

Trefwoorden en vlaggen Gebeurtenissen voor het laden/verwijderen van toepassingsdomeinen, assembly's en modules Gebeurtenissen voor het laden/verwijderen van de methode (behalve dynamische gebeurtenissen) Gebeurtenissen laden/vernietigen van dynamische methode
LoaderKeyword Gebeurtenissen laden en uitpakken. Geen. Geen.
JITKeyword

(+ StartEnumerationKeyword voegt niets toe)		 Geen. Gebeurtenissen laden. Gebeurtenissen laden en uitpakken.
JITKeyword +

EndEnumerationKeyword		 Geen. Gebeurtenissen laden en uitpakken. Gebeurtenissen laden en uitpakken.
NGenKeyword Geen. Geen. Niet van toepassing.
NGenKeyword +

StartEnumerationKeyword		 Geen. Gebeurtenissen laden. Niet van toepassing.
NGenKeyword +

EndEnumerationKeyword		 Geen. Gebeurtenissen uitpakken. Niet van toepassing.

Trefwoordcombinaties voor symboolresolutie voor de Rundown-provider

Trefwoorden en vlaggen Toepassingsdomein, assembly, module DCStart/DCEnd-gebeurtenissen Methode DCStart/DCEnd-gebeurtenissen (inclusief dynamische methodegebeurtenissen)
LoaderRundownKeyword +

StartRundownKeyword		 DCStart Gebeurtenissen. Geen.
LoaderRundownKeyword +

EndRundownKeyword		 DCEnd Gebeurtenissen. Geen.
JITKeyword +

StartRundownKeyword		 Geen. DCStart Gebeurtenissen.
JITKeyword +

EndRundownKeyword		 Geen. DCEnd Gebeurtenissen.
NGenKeyword +

StartRundownKeyword		 Geen. DCStart Gebeurtenissen.
NGenKeyword +

EndRundownKeyword		 Geen. DCEnd Gebeurtenissen.

ETW-gebeurtenisniveaus

ETW-gebeurtenissen kunnen ook worden gefilterd op niveau. Als het niveau is ingesteld op 0x5, worden gebeurtenissen van alle niveaus, inclusief 0x5 en lager (dit zijn gebeurtenissen die behoren tot categorieën die via trefwoorden zijn ingeschakeld) verhoogd. Als het niveau is ingesteld op 0x2, worden alleen gebeurtenissen gegenereerd die behoren tot het niveau 0x2 en lager.

De niveaus hebben de volgende betekenis:

0x5 - Uitgebreid

0x4 - Informatie

0x3 - Waarschuwing

0x2 - Fout

0x1 - Kritiek

0x0 - LogAlways

Zie ook