Dela via

CLR ETW-nyckelord och -nivåer

  • Artikel

Händelsespårning för Windows-händelser (ETW) kan filtreras efter kategori och nivå. Med ETW-nyckelord för händelse-CLR kan du filtrera händelser efter kategori. de används i kombinationer för körnings- och körningsprovidrar. Händelsenivåerna identifieras med flaggor.

CLR ETW-nyckelord

Nyckelorden är flaggor som kan kombineras för att generera värden. I praktiken använder du hexadecimala värden för nyckelorden i stället för nyckelordsnamnen när du anropar kommandoradsverktygen.

Nyckelorden beskrivs i följande tabeller:

CLR ETW Runtime-nyckelord

I följande tabell visas CLR ETW-körningsnyckelord, deras värden och vad de används för.

Körningsnyckelordnamn Värde Syfte
GCKeyword 0x00000001 Aktiverar insamling av skräpinsamlingshändelser.
LoaderKeyword 0x00000008 Aktiverar insamling av inläsningshändelser.
JITKeyword 0x00000010 Aktiverar insamling av JIT-händelser (just-in-time).
NGenKeyword 0x00000020 Aktiverar insamling av händelser för interna avbildningsmetoder (metoder som bearbetas av den interna avbildningsgeneratorn Ngen.exe); används med StartEnumerationKeyword och EndEnumerationKeyword. Det här nyckelordet har höga omkostnader. Den genererar händelser för varje metod i varje inläst NGen-modul. I stället för att använda det här nyckelordet rekommenderar vi att du använder de programdatabaser (PDB) som genereras av profileringsverktyg för att hämta information om metoder från NGen-moduler. Se även OverrideAndSuppressNGenEventsKeyword senare i den här tabellen.
StartEnumerationKeyword 0x00000040 Aktiverar uppräkning av alla metoder i körningen. används tillsammans med NGenKeyword.
EndEnumerationKeyword 0x00000080 Aktiverar uppräkning av alla metoder som förstörs under körningen. används tillsammans med JITKeyword och NGenKeyword.
SecurityKeyword 0x00000400 Aktiverar insamling av säkerhetshändelser.
AppDomainResourceManagementKeyword 0x00000800 Aktiverar insamling av resursövervakningshändelser på programdomännivå.
JITTracingKeyword 0x00001000 Aktiverar insamling av JIT-spårningshändelser.
InteropKeyword 0x00002000 Aktiverar insamling av interop-händelser.
ContentionKeyword 0x00004000 Aktiverar insamling av konkurrenshändelser.
ExceptionKeyword 0x00008000 Aktiverar insamling av undantagshändelser.
ThreadingKeyword 0x00010000 Aktiverar insamling av trådpoolshändelser.
OverrideAndSuppressNGenEventsKeyword 0x00040000 (Tillgänglig i .NET Framework 4.5 och senare.) Undertrycker nyckelordet med höga kostnader NGenKeyword och förhindrar generering av händelser för metoder som finns i NGen-moduler. Från och med .NET Framework 4.5 bör profileringsverktyg använda OverrideAndSuppressNGenEventsKeyword och NGenKeyword tillsammans förhindra generering av händelser för metoder i NGen-moduler. Detta gör det möjligt för profileringsverktyget att använda de mer effektiva NGen-PDB:erna för att få information om metoder i NGen-moduler. CLR i .NET Framework 4 och tidigare versioner stöder inte skapandet av NGen-PDU:er. I dessa tidigare versioner känner CLR inte igen OverrideAndSuppressNGenEventsKeyword och bearbetar NGenKeyword för att generera händelser för metoder i NGen-moduler.
PerfTrackKeyWord 0x2000000 Aktiverar insamling av ModuleLoad händelserna och ModuleRange .
StackKeyword 0x40000000 Aktiverar insamling av CLR-stackspårningshändelser.

CLR ETW Rundown-nyckelord

I följande tabell visas nyckelorden för CLR ETW-rundown, deras värden och vad de används för.

Nyckelordsnamn för nedkörd körning Värde Syfte
LoaderRundownKeyword 0x00000008 Aktiverar insamling av inläsningshändelser när den används med StartRundownKeyword och EndRundownKeyword.
JitRundownKeyword 0x00000010 Aktiverar insamling av metoder DCStart och DCEnd händelser för JIT-kompilerade metoder när de används med StartRundownKeyword och EndRundownKeyword.
NGenRundownKeyword 0x00000020 Aktiverar insamling av metoder DCStart och DCEnd händelser för NGen-inbyggda avbildningsmetoder när de används med StartRundownKeyword och EndRundownKeyword. Det här nyckelordet har höga omkostnader. Den genererar händelser för varje metod i varje inläst NGen-modul. I stället för att använda det här nyckelordet rekommenderar vi att du använder de programdatabaser (PDB) som genereras av profileringsverktyg för att hämta information om metoder från NGen-moduler. Se även OverrideAndSuppressNGenEventsRundownKeyword senare i den här tabellen.
StartRundownKeyword 0x00000040 Aktiverar uppräkning av systemtillstånd under en startkörning.
EndRundownKeyword 0x00000100 Aktiverar uppräkning av systemtillstånd under en slutkörning.
AppDomainResourceManagementRundownKeyword 0x00000800 Aktiverar insamling av händelser för resursövervakning på en AppDomain nivå när den används med StartRundownKeyword eller EndRundownKeyword.
ThreadingKeyword 0x00010000 Aktiverar insamling av trådpoolshändelser.
OverrideAndSuppressNGenEventsRundownKeyword 0x00040000 (Tillgänglig i .NET Framework 4.5 och senare.) Undertrycker nyckelordet med höga kostnader NGenRundownKeyword och förhindrar generering av händelser för metoder som finns i NGen-moduler. Från och med .NET Framework 4.5 bör profileringsverktyg använda OverrideAndSuppressNGenEventsRundownKeyword och NGenRundownKeyword tillsammans förhindra generering av händelser för metoder i NGen-moduler. Detta gör det möjligt för profileringsverktyget att använda de mer effektiva NGen-PDB:erna för att få information om metoder i NGen-moduler. CLR i .NET Framework 4 och tidigare versioner stöder inte skapandet av NGen-PDU:er. I dessa tidigare versioner känner CLR inte igen OverrideAndSuppressNGenEventsRundownKeyword och bearbetar NGenRundownKeyword för att generera händelser för metoder i NGen-moduler.
PerfTrackKeyWord 0x2000000 Aktiverar samlingen av ModuleDCStarthändelserna , ModuleDCEnd, ModuleRangeDCStartoch ModuleRangeDCEnd .

Nyckelordskombinationer för symbolmatchning för Körningsprovidern

Nyckelord och flaggor Programdomän, sammansättning, händelser för modulinläsning/avlastning Metodinläsning/avlastningshändelser (förutom dynamiska händelser) Händelser för dynamisk metodinläsning/störande
LoaderKeyword Läsa in och ta bort händelser. Inga. Inga.
JITKeyword

(+ StartEnumerationKeyword lägger inte till något)		 Inga. Läs in händelser. Läsa in och ta bort händelser.
JITKeyword +

EndEnumerationKeyword		 Inga. Läsa in och ta bort händelser. Läsa in och ta bort händelser.
NGenKeyword Inga. Inga. Inte tillämpligt.
NGenKeyword +

StartEnumerationKeyword		 Inga. Läs in händelser. Inte tillämpligt.
NGenKeyword +

EndEnumerationKeyword		 Inga. Ta bort händelser. Inte tillämpligt.

Nyckelordskombinationer för symbolmatchning för Rundown-providern

Nyckelord och flaggor Programdomän, sammansättning, dcstart-/DCEnd-händelser för modulen Metod-DCStart/DCEnd-händelser (inklusive dynamiska metodhändelser)
LoaderRundownKeyword +

StartRundownKeyword		 DCStart Händelser. Inga.
LoaderRundownKeyword +

EndRundownKeyword		 DCEnd Händelser. Inga.
JITKeyword +

StartRundownKeyword		 Inga. DCStart Händelser.
JITKeyword +

EndRundownKeyword		 Inga. DCEnd Händelser.
NGenKeyword +

StartRundownKeyword		 Inga. DCStart Händelser.
NGenKeyword +

EndRundownKeyword		 Inga. DCEnd Händelser.

ETW-händelsenivåer

ETW-händelser kan också filtreras efter nivå. Om nivån anges till 0x5 utlöses händelser på alla nivåer, inklusive 0x5 och lägre (som är händelser som tillhör kategorier som aktiveras via nyckelord). Om nivån anges till 0x2 utlöses endast händelser som tillhör nivå 0x2 och nedan.

Nivåerna har följande betydelser:

0x5 – utförlig

0x4 – information

0x3 – Varning

0x2 – fel

0x1 – kritisk

0x0 – LogAlways

Se även