CLR ETW kulcsszavak és szintek

A Windows-események (ETW) esemény-nyomkövetése kategória és szint szerint szűrhető. Az esemény CLR ETW-kulcsszavai lehetővé teszik az események kategória szerinti szűrését; a futtatókörnyezeti és a futtatókörnyezeti szolgáltatók kombinációiban használják őket. Az eseményszinteket jelzők azonosítják.

CLR ETW kulcsszavak

A kulcsszavak olyan jelzők, amelyek kombinálhatók az értékek létrehozásához. A gyakorlatban a parancssori segédprogramok hívásakor a kulcsszavak hexadecimális értékeit használja a kulcsszónevek helyett.

A kulcsszavakat a következő táblázatok ismertetik:

• CLR ETW futtatókörnyezeti kulcsszavak

• CLR ETW rundown kulcsszavak

• Kulcsszókombinációk a futtatókörnyezet-szolgáltató szimbólumfeloldási funkciójához

• Kulcsszavas kombinációk a lefutó szolgáltató szimbólumfeloldási funkciójához

CLR ETW futtatókörnyezeti kulcsszavak

Az alábbi táblázat a CLR ETW futtatókörnyezeti kulcsszavakat, azok értékeit és a használt adatokat sorolja fel.

Futtatókörnyezet kulcsszóneve	Érték	Cél
GCKeyword	0x00000001	Engedélyezi a szemétgyűjtési események gyűjtését.
LoaderKeyword	0x00000008	Engedélyezi a betöltőesemények gyűjtését.
JITKeyword	0x00000010	Engedélyezi az igény szerinti (JIT) események gyűjtését.
NGenKeyword	0x00000020	Engedélyezi az események gyűjtését natív rendszerkép-metódusokhoz (a Native Image Generator által feldolgozott metódusok, Ngen.exe); a és EndEnumerationKeyworda használatával StartEnumerationKeyword használható. Ez a kulcsszó nagy többletterhelést okoz. Eseményeket hoz létre minden metódushoz minden betöltött NGen-modulban. Ha lehetséges, a kulcsszó használata helyett azt javasoljuk, hogy a profilkészítési eszközök által létrehozott programadatbázisokat (PDB-ket) használja a metódusokkal kapcsolatos információk NGen-modulokból való lekéréséhez. OverrideAndSuppressNGenEventsKeyword Lásd még a táblázat későbbi részében.
StartEnumerationKeyword	0x00000040	Engedélyezi az összes metódus enumerálását a futtatókörnyezetben; a következővel NGenKeywordegyütt használatos: .
EndEnumerationKeyword	0x00000080	Lehetővé teszi a futtatókörnyezetben megsemmisített összes metódus számbavételét; a és NGenKeyworda használatával JITKeyword együtt használatos.
SecurityKeyword	0x00000400	Engedélyezi a biztonsági események gyűjtését.
AppDomainResourceManagementKeyword	0x00000800	Lehetővé teszi az erőforrás-monitorozási események gyűjtését egy alkalmazástartomány szintjén.
JITTracingKeyword	0x00001000	Engedélyezi a JIT-nyomkövetési események gyűjtését.
InteropKeyword	0x00002000	Lehetővé teszi az interop események gyűjtését.
ContentionKeyword	0x00004000	Engedélyezi a versengési események gyűjtését.
ExceptionKeyword	0x00008000	Engedélyezi a kivételesemények gyűjtését.
ThreadingKeyword	0x00010000	Engedélyezi a szálkészletes események gyűjtését.
OverrideAndSuppressNGenEventsKeyword	0x00040000	(A .NET-keretrendszer 4.5-ös és újabb verzióiban érhető el.) Letiltja a magas terhelésű kulcsszótNGenKeyword, és megakadályozza az NGen-modulokban található metódusok eseményeinek létrehozását. A .NET-keretrendszer 4.5-től kezdve a profilkészítési eszközöknek együtt kell használniuk OverrideAndSuppressNGenEventsKeyword az NGenKeyword NGen-modulok metódusainak eseménygenerálását. Ez lehetővé teszi, hogy a profilkészítési eszköz a hatékonyabb NGen PDB-eket használja az NGen-modulok metódusainak információinak lekéréséhez. A .NET-keretrendszer 4-.NET-keretrendszer korábbi verzióiban a CLR nem támogatja az NGen PDB-k létrehozását. Ezekben a korábbi verziókban a CLR nem ismeri fel OverrideAndSuppressNGenEventsKeyword és NGenKeyword dolgozza fel az NGen-modulok metódusainak eseményeit.
PerfTrackKeyWord	0x2000000	Engedélyezi a és ModuleRange az események gyűjtésétModuleLoad.
StackKeyword	0x40000000	Engedélyezi a CLR-verem nyomkövetési eseményeinek gyűjtését.

CLR ETW rundown kulcsszavak

Az alábbi táblázat felsorolja a CLR ETW-futtató kulcsszavakat, azok értékeit, és hogy mire használják őket.

Rundown kulcsszó neve	Érték	Cél
LoaderRundownKeyword	0x00000008	Engedélyezi a betöltőesemények gyűjtését, ha a és EndRundownKeyworda használatával StartRundownKeyword használja.
JitRundownKeyword	0x00000010	Lehetővé teszi a JIT által lefordított metódusok metódusainak DCStart és DCEnd eseményeinek gyűjtését a és EndRundownKeyworda használatávalStartRundownKeyword.
NGenRundownKeyword	0x00000020	Lehetővé teszi az NGen natív rendszerképmetódusainak metódusainak DCStart és DCEnd eseményeinek gyűjtését a és EndRundownKeyworda használatávalStartRundownKeyword. Ez a kulcsszó nagy többletterhelést okoz. Eseményeket hoz létre minden metódushoz minden betöltött NGen-modulban. Ha lehetséges, a kulcsszó használata helyett azt javasoljuk, hogy a profilkészítési eszközök által létrehozott programadatbázisokat (PDB-ket) használja a metódusokkal kapcsolatos információk NGen-modulokból való lekéréséhez. OverrideAndSuppressNGenEventsRundownKeyword Lásd még a táblázat későbbi részében.
StartRundownKeyword	0x00000040	Lehetővé teszi a rendszerállapot enumerálását egy indítási lefutás során.
EndRundownKeyword	0x00000100	Lehetővé teszi a rendszerállapot enumerálását egy lefuttatás során.
AppDomainResourceManagementRundownKeyword	0x00000800	Engedélyezi az események gyűjtését az erőforrás-monitorozáshoz egy AppDomain szinten, ha a vagy EndRundownKeyworda használatával StartRundownKeyword használja.
ThreadingKeyword	0x00010000	Engedélyezi a szálkészletes események gyűjtését.
OverrideAndSuppressNGenEventsRundownKeyword	0x00040000	(A .NET-keretrendszer 4.5-ös és újabb verzióiban érhető el.) Letiltja a magas terhelésű kulcsszótNGenRundownKeyword, és megakadályozza az NGen-modulokban található metódusok eseményeinek létrehozását. A .NET-keretrendszer 4.5-től kezdve a profilkészítési eszközöknek együtt kell használniuk OverrideAndSuppressNGenEventsRundownKeyword az NGenRundownKeyword NGen-modulok metódusainak eseménygenerálását. Ez lehetővé teszi, hogy a profilkészítési eszköz a hatékonyabb NGen PDB-eket használja az NGen-modulok metódusainak információinak lekéréséhez. A .NET-keretrendszer 4-.NET-keretrendszer korábbi verzióiban a CLR nem támogatja az NGen PDB-k létrehozását. Ezekben a korábbi verziókban a CLR nem ismeri fel OverrideAndSuppressNGenEventsRundownKeyword és NGenRundownKeyword dolgozza fel az NGen-modulok metódusainak eseményeit.
PerfTrackKeyWord	0x2000000	Engedélyezi a , ModuleDCEnd, ModuleRangeDCStartés ModuleRangeDCEnd események gyűjtésétModuleDCStart.

A futtatókörnyezet-szolgáltató szimbólumfeloldási kulcsszókombinációi

Kulcsszavak és jelzők	Alkalmazástartomány, szerelvény, modulbetöltési/-eltávolítási események	Metódusbetöltési/-eltávolítási események (a dinamikus események kivételével)	Dinamikus metódusbetöltés/események megsemmisítése
LoaderKeyword	Események betöltése és eltávolítása.	Nincsenek.	Nincsenek.
JITKeyword (+ StartEnumerationKeyword nem ad hozzá semmit)	Nincsenek.	Események betöltése.	Események betöltése és eltávolítása.
JITKeyword + EndEnumerationKeyword	Nincsenek.	Események betöltése és eltávolítása.	Események betöltése és eltávolítása.
NGenKeyword	Nincsenek.	Nincsenek.	Nem alkalmazható.
NGenKeyword + StartEnumerationKeyword	Nincsenek.	Események betöltése.	Nem alkalmazható.
NGenKeyword + EndEnumerationKeyword	Nincsenek.	Események eltávolítása.	Nem alkalmazható.

Kulcsszókombinációk a lefuttatási szolgáltató szimbólumfeloldási funkciójához

Kulcsszavak és jelzők	Alkalmazástartomány, szerelvény, DCStart/DCEnd modulesemények	DCStart/DCEnd metódusesemények (a dinamikus metóduseseményeket is beleértve)
LoaderRundownKeyword + StartRundownKeyword	DCStart Események.	Nincsenek.
LoaderRundownKeyword + EndRundownKeyword	DCEnd Események.	Nincsenek.
JITKeyword + StartRundownKeyword	Nincsenek.	DCStart Események.
JITKeyword + EndRundownKeyword	Nincsenek.	DCEnd Események.
NGenKeyword + StartRundownKeyword	Nincsenek.	DCStart Események.
NGenKeyword + EndRundownKeyword	Nincsenek.	DCEnd Események.

ETW eseményszintek

Az ETW-események szint szerint is szűrhetők. Ha a szint 0x5 van beállítva, az összes szint eseményei, beleértve a 0x5 és az alatti eseményeket (amelyek kulcsszavakon keresztül engedélyezett kategóriákhoz tartoznak) lesznek emelve. Ha a szint 0x2 van beállítva, csak az 0x2 és az alábbi szinthez tartozó események lesznek emelve.

A szintek jelentése a következő:

0x5 – Részletes

0x4 – Tájékoztató

0x3 – Figyelmeztetés

0x2 – Hiba

0x1 – Kritikus

0x0 – LogAlways

Lásd még

• CLR ETW-szolgáltatók
• CLR ETW-események
• ETW-események a Common Language Runtime-ban