Loader ETW-händelser
Dessa händelser samlar in information om inläsning och avlastning av programdomäner, sammansättningar och moduler.
Alla inläsningshändelser genereras under nyckelordet LoaderKeyword (0x8). Händelserna DCStart och DCEnd genereras under LoaderRundownKeyword (0x8) medEndRundownStartRundown/aktiverat. (Mer information finns i CLR ETW-nyckelord och -nivåer.)
Programdomänhändelser
I följande tabell visas nyckelordet och nivån.
| Nyckelord för att höja händelsen | Event | Nivå |
|---|---|---|
LoaderKeyword (0x8) |
AppDomainLoad_V1 och AppDomainUnLoad_V1 |
Information (4) |
LoaderRundownKeyword (0x8) +StartRundownKeyword |
AppDomainDCStart_V1 |
Information (4) |
LoaderRundownKeyword (0x8) +EndRundownKeyword |
AppDomainDCEnd_V1 |
Information (4) |
I följande tabell visas händelseinformationen.
| Event | Händelse-ID | beskrivning |
|---|---|---|
AppDomainLoad_V1 (loggas för alla programdomäner) |
156 | Utlöses när en programdomän skapas under en processs livslängd. |
AppDomainUnLoad_V1 |
157 | Genereras när en programdomän förstörs under en processs livslängd. |
AppDomainDCStart_V1 |
157 | Räknar upp programdomänerna under en startkörning. |
AppDomainDCEnd_V1 |
158 | Räknar upp programdomänerna under en slutkörning. |
I följande tabell visas händelsedata.
| Fältnamn | Datatyp | beskrivning |
|---|---|---|
| AppDomainID | win:UInt64 | Den unika identifieraren för en programdomän. |
| AppDomainFlags | win:UInt32 | 0x1: Standarddomän. 0x2: Körbar. 0x4: Programdomän, bit 28-31: Delningsprincip för den här domänen. 0: En delad domän. |
| AppDomainName | win:UnicodeString | Eget programdomännamn. Kan ändras under processens livslängd. |
| AppDomainIndex | Win:UInt32 | Indexet för den här programdomänen. |
| ClrInstanceID | win:UInt16 | Unikt ID för instansen av CLR eller CoreCLR. |
CLR Loader-sammansättningshändelser
I följande tabell visas nyckelordet och nivån.
| Nyckelord för att höja händelsen | Event | Nivå |
|---|---|---|
LoaderKeyword (0x8) |
AssemblyLoad och AssemblyUnload |
Information (4) |
LoaderRundownKeyword (0x8) +StartRundownKeyword |
AssemblyDCStart |
Information (4) |
LoaderRundownKeyword (0x8) +EndRundownKeyword |
AssemblyDCEnd |
Information (4) |
I följande tabell visas händelseinformationen.
| Event | Händelse-ID | beskrivning |
|---|---|---|
AssemblyLoad_V1 |
154 | Upphöjt när en sammansättning läses in. |
AssemblyUnload_V1 |
155 | Upphöjt när en sammansättning tas bort. |
AssemblyDCStart_V1 |
155 | Räknar upp sammansättningar under en startkörning. |
AssemblyDCEnd_V1 |
156 | Räknar upp sammansättningar under en slutkörning. |
I följande tabell visas händelsedata.
| Fältnamn | Datatyp | beskrivning |
|---|---|---|
| AssemblyID | win:UInt64 | Unikt ID för sammansättningen. |
| AppDomainID | win:UInt64 | ID för domänen för den här sammansättningen. |
| BindingID | win:UInt64 | ID som unikt identifierar sammansättningsbindningen. |
| AssemblyFlags | win:UInt32 | 0x1: Domänneutral sammansättning. 0x2: Dynamisk sammansättning. 0x4: Sammansättningen har en intern avbildning. 0x8: Samlingsbar sammansättning. |
| AssemblyName | win:UnicodeString | Fullständigt kvalificerat sammansättningsnamn. |
| ClrInstanceID | win:UInt16 | Unikt ID för instansen av CLR eller CoreCLR. |
Modulhändelser
I följande tabell visas nyckelordet och nivån.
| Nyckelord för att höja händelsen | Event | Nivå |
|---|---|---|
LoaderKeyword (0x8) |
ModuleLoad_V2 och ModuleUnload_V2 |
Information (4) |
LoaderRundownKeyword (0x8) +StartRundownKeyword |
ModuleDCStart_V2 |
Information (4) |
LoaderRundownKeyword (0x8) +EndRundownKeyword |
ModuleDCEnd_V2 |
Information (4) |
I följande tabell visas händelseinformationen.
| Event | Händelse-ID | beskrivning |
|---|---|---|
ModuleLoad_V2 |
152 | Utlöses när en modul läses in under en processs livslängd. |
ModuleUnload_V2 |
153 | Utlöses när en modul tas bort under en processs livslängd. |
ModuleDCStart_V2 |
153 | Räknar upp moduler under en startkörning. |
ModuleDCEnd_V2 |
154 | Räknar upp moduler under en slutkörning. |
I följande tabell visas händelsedata.
| Fältnamn | Datatyp | beskrivning |
|---|---|---|
| ModuleID | win:UInt64 | Unikt ID för modulen. |
| AssemblyID | win:UInt64 | ID för sammansättningen där den här modulen finns. |
| ModuleFlags | win:UInt32 | 0x1: Domänneutral modul. 0x2: Modulen har en intern avbildning. 0x4: Dynamisk modul. 0x8: Manifestmodul. |
| Reserverad1 | win:UInt32 | Reserverat fält. |
| ModuleILPath | win:UnicodeString | Sökväg till den gemensamma mellanliggande språkbilden (CIL) för modulen eller namnet på den dynamiska modulen om det är en dynamisk sammansättning (null-terminated). |
| ModuleNativePath | win:UnicodeString | Sökväg till modulens interna avbildning, om den finns (null-avslutad). |
| ClrInstanceID | win:UInt16 | Unikt ID för instansen av CLR eller CoreCLR. |
| ManagedPdbSignature | win:GUID | GUID-signatur för den hanterade programdatabasen (PDB) som matchar den här modulen. (Se Kommentarer.) |
| ManagedPdbAge | win:UInt32 | Åldersnummer skrivet till det hanterade PDB som matchar den här modulen. (Se Kommentarer.) |
| ManagedPdbBuildPath | win:UnicodeString | Sökväg till den plats där det hanterade PDB som matchar den här modulen skapades. I vissa fall kan detta bara vara ett filnamn. (Se Kommentarer.) |
| NativePdbSignature | win:GUID | GUID-signatur för pdB för den interna avbildningsgeneratorn (NGen) som matchar den här modulen, om tillämpligt. (Se Kommentarer.) |
| NativePdbAge | win:UInt32 | Åldersnummer skrivet till NGen PDB som matchar den här modulen, om tillämpligt. (Se Kommentarer.) |
| NativePdbBuildPath | win:UnicodeString | Sökväg till den plats där NGen PDB som matchar den här modulen skapades, om tillämpligt. I vissa fall kan detta bara vara ett filnamn. (Se Kommentarer.) |
Kommentarer
Fälten som har "Pdb" i sina namn kan användas av profileringsverktyg för att hitta PDF-filer som matchar de moduler som lästes in under profileringssessionen. Värdena för dessa fält motsvarar de data som skrivs in i de IMAGE_DIRECTORY_ENTRY_DEBUG avsnitten i modulen som normalt används av felsökare för att hitta PDF-filer som matchar de inlästa modulerna.
Fältnamnen som börjar med "ManagedPdb" refererar till det hanterade PDB som motsvarar CIL-modulen som genererades av den hanterade kompilatorn (till exempel C# eller Visual Basic-kompilatorn). Detta PDB använder det hanterade PDB-formatet och beskriver hur element från den ursprungliga hanterade källkoden, till exempel filer, radnummer och symbolnamn, mappa till CIL-element som kompileras till CIL-modulen.
Fältnamnen som börjar med "NativePdb" refererar till NGen PDB som genereras genom att anropa
NGEN createPDB. Den här PDB använder det inbyggda PDB-formatet och beskriver hur element från den ursprungliga hanterade källkoden, till exempel filer, radnummer och symbolnamn, mappar till inbyggda element som kompileras till NGen-modulen.
Händelser i CLR-domänmodulen
I följande tabell visas nyckelordet och nivån.
| Nyckelord för att höja händelsen | Event | Nivå |
|---|---|---|
LoaderKeyword (0x8) |
DomainModuleLoad_V1 |
Information (4) |
LoaderRundownKeyword (0x8) +StartRundownKeyword |
DomainModuleDCStart_V1 |
Information (4) |
LoaderRundownKeyword (0x8) +EndRundownKeyword |
DomainModuleDCEnd_V1 |
Information (4) |
I följande tabell visas händelseinformationen.
| Event | Händelse-ID | beskrivning |
|---|---|---|
DomainModuleLoad_V1 |
151 | Utlöses när en modul läses in för en programdomän. |
DomainModuleDCStart_V1 |
151 | Räknar upp moduler som läses in för en programdomän under en startkörning och loggas för alla programdomäner. |
DomainModuleDCEnd_V1 |
152 | Räknar upp moduler som läses in för en programdomän under en slutkörning och loggas för alla programdomäner. |
I följande tabell visas händelsedata.
| Fältnamn | Datatyp | beskrivning |
|---|---|---|
| ModuleID | win:UInt64 | Identifierar den sammansättning som den här modulen tillhör. |
| AssemblyID | win:UInt64 | ID för sammansättningen där den här modulen finns. |
| AppDomainID | win:UInt64 | ID för programdomänen där den här modulen används. |
| ModuleFlags | win:UInt32 | 0x1: Domänneutral modul. 0x2: Modulen har en intern avbildning. 0x4: Dynamisk modul. 0x8: Manifestmodul. |
| Reserverad1 | win:UInt32 | Reserverat fält. |
| ModuleILPath | win:UnicodeString | Sökväg till CIL-avbildningen för modulen eller namnet på den dynamiska modulen om det är en dynamisk sammansättning (null-avslutad). |
| ModuleNativePath | win:UnicodeString | Sökväg till modulens interna avbildning, om den finns (null-avslutad). |
| ClrInstanceID | win:UInt16 | Unikt ID för instansen av CLR eller CoreCLR. |
Händelser för modulintervall
I följande tabell visas nyckelordet och nivån.
| Nyckelord för att höja händelsen | Event | Nivå |
|---|---|---|
PerfTrackKeyWord) |
ModuleRange |
Information (4) |
PerfTrackKeyWord |
ModuleRangeDCStart |
Information (4) |
PerfTrackKeyWord |
ModuleRangeDCEnd |
Information (4) |
I följande tabell visas händelseinformationen.
| Event | Händelse-ID | beskrivning |
|---|---|---|
ModuleRange |
158 | Den här händelsen finns om en inläst NGen-avbildning (Native Image Generator) har optimerats med IBC och innehåller information om de heta avsnitten i NGen-avbildningen. |
ModuleRangeDCStart |
160 | En ModuleRange händelse utlöstes i början av en körning. |
ModuleRangeDCEnd |
161 | En ModuleRange händelse utlöstes i slutet av en nedkörning. |
I följande tabell visas händelsedata.
| Fältnamn | Datatyp | beskrivning |
|---|---|---|
| ClrInstanceID | win:UInt16 | Identifierar unikt en specifik instans av CLR i en process om flera instanser av CLR läses in. |
| ModuleID | win:UInt64 | Identifierar den sammansättning som den här modulen tillhör. |
| RangeBegin | win:UInt32 | Förskjutningen i modulen som representerar början av intervallet för den angivna intervalltypen. |
| RangeSize | win:UInt32 | Storleken på det angivna intervallet i byte. |
| RangeType | win:UInt32 | Ett enda värde, 0x4, som representerar kalla IBC-intervall. Det här fältet kan representera fler värden i framtiden. |
| RangeSize1 | win:UInt32 | 0 anger felaktiga data. |
| RangeBegin2 | win:UnicodeString |
Kommentarer
Om en inläst NGen-avbildning i en .NET Framework-process har optimerats med IBC loggas händelsen ModuleRange som innehåller de frekventa intervallen i NGen-avbildningen tillsammans med dess moduleID och ClrInstanceID. Om NGen-avbildningen inte är optimerad med IBC loggas inte den här händelsen. För att fastställa modulnamnet måste den här händelsen sorteras med modulens inläsning av ETW-händelser.
Nyttolaststorleken för den här händelsen är variabel. fältet Count anger antalet intervallförskjutningar som ingår i händelsen. Den här händelsen måste sorteras med Windows-händelsen IStart för att fastställa de faktiska intervallen. Händelsen Windows Image Load loggas när en avbildning läses in och innehåller den virtuella adressen för den inlästa avbildningen.
Modulintervallhändelser utlöses på en ETW-nivå som är större än eller lika med 4 och klassificeras som informationshändelser.
