Événements de méthode du runtime .NET

Article
05/10/2023

Les événements décrits dans cet article collectent des informations propres aux méthodes. La charge utile de ces événements est requise pour la résolution des symboles. En outre, ces événements fournissent des informations utiles, telles que des méthodes chargées et déchargées. Pour plus d’informations sur l’utilisation de ces événements à des fins de diagnostic, consultez Journalisation et suivi .NET

Tous les événements de méthode ont le niveau « Informations (4) ». Tous les événements détaillés de méthode ont le niveau « Détaillé (5) ».

Tous les événements de méthode sont déclenchés par le mot clé JITKeyword (0x10) ou NGenKeyword (0x20) sous le fournisseur de runtime, ou par le mot clé JitRundownKeyword (0x10) ou NGENRundownKeyword (0x20) sous le fournisseur d’arrêt.

Les versions V2 de ces événements incluent reJITID, mais pas les versions V1.

Événement MethodLoad_V1

Le tableau ci-dessous montre les informations liées aux événements.

Événement	ID de l’événement	Description
`MethodLoad_V1`	141	Déclenché quand une méthode est chargée juste-à-temps (JIT) ou quand une image NGEN est chargée. Les méthodes dynamiques et génériques n'utilisent pas cette version pour les chargements de méthodes. Les programmes d'assistance JIT n'utilisent jamais cette version.

Mot clé pour déclencher l'événement	Level
`JITKeyword` (0x10)	Informatif (4)
`NGenKeyword` (0x20)	Informatif (4)

Nom du champ	Type de données	Description
`MethodID`	`win:UInt64`	Identificateur unique d’une méthode. Pour les méthodes d'assistance JIT, sa valeur correspond à l'adresse de début de la méthode.
`ModuleID`	`win:UInt64`	Identificateur du module auquel cette méthode appartient (0 pour les programmes d'assistance JIT).
`MethodStartAddress`	`win:UInt64`	Adresse de début de la méthode.
`MethodSize`	`win:UInt32`	Taille de la méthode.
`MethodToken`	`win:UInt32`	0 pour les méthodes dynamiques et les programmes d'assistance JIT.
`MethodFlags`	`win:UInt32`	0x1 : méthode dynamique. 0x2 : méthode générique. 0x4 : méthode de code compilé juste-à-temps (JIT) (ou code d'image natif NGEN). 0x8 : méthode d'assistance.
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Événement MethodLoad_V2

Événement	ID de l’événement	Description
`MethodLoad_V2`	141	Déclenché quand une méthode est chargée juste-à-temps (JIT) ou quand une image NGEN est chargée. Les méthodes dynamiques et génériques n'utilisent pas cette version pour les chargements de méthodes. Les programmes d'assistance JIT n'utilisent jamais cette version.

Mot clé pour déclencher l'événement	Level
`JITKeyword` (0x10)	Informatif (4)
`NGenKeyword` (0x20)	Informatif (4)

Nom du champ	Type de données	Description
`MethodID`	`win:UInt64`	Identificateur unique d’une méthode. Pour les méthodes d'assistance JIT, sa valeur correspond à l'adresse de début de la méthode.
`ModuleID`	`win:UInt64`	Identificateur du module auquel cette méthode appartient (0 pour les programmes d'assistance JIT).
`MethodStartAddress`	`win:UInt64`	Adresse de début de la méthode.
`MethodSize`	`win:UInt32`	Taille de la méthode.
`MethodToken`	`win:UInt32`	0 pour les méthodes dynamiques et les programmes d'assistance JIT.
`MethodFlags`	`win:UInt32`	0x1 : méthode dynamique. 0x2 : méthode générique. 0x4 : méthode de code compilé juste-à-temps (JIT) (ou code d'image natif NGEN). 0x8 : méthode d'assistance.
`ReJITID`	`win:UInt64`	ID ReJIT de la méthode.
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Événement MethodUnLoad_V1

Événement	ID de l’événement	Description
`MethodUnLoad_V1`	142	Déclenché quand un module est déchargé ou quand un domaine d'application est détruit. Les méthodes dynamiques n'utilisent jamais cette version pour les déchargements de méthodes.

Mot clé pour déclencher l'événement	Level
`JITKeyword` (0x10)	Informatif (4)
`NGenKeyword` (0x20)	Informatif (4)

Nom du champ	Type de données	Description
`MethodID`	`win:UInt64`	Identificateur unique d’une méthode. Pour les méthodes d'assistance JIT, sa valeur correspond à l'adresse de début de la méthode.
`ModuleID`	`win:UInt64`	Identificateur du module auquel cette méthode appartient (0 pour les programmes d'assistance JIT).
`MethodStartAddress`	`win:UInt64`	Adresse de début de la méthode.
`MethodSize`	`win:UInt32`	Taille de la méthode.
`MethodToken`	`win:UInt32`	0 pour les méthodes dynamiques et les programmes d'assistance JIT.
`MethodFlags`	`win:UInt32`	0x1 : méthode dynamique. 0x2 : méthode générique. 0x4 : méthode de code compilé juste-à-temps (JIT) (ou code d'image natif NGEN). 0x8 : méthode d'assistance.
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Événement MethodUnLoad_V2

Événement	ID de l’événement	Description
`MethodUnLoad_V2`	142	Déclenché quand un module est déchargé ou quand un domaine d'application est détruit. Les méthodes dynamiques n'utilisent jamais cette version pour les déchargements de méthodes.

Mot clé pour déclencher l'événement	Level
`JITKeyword` (0x10)	Informatif (4)
`NGenKeyword` (0x20)	Informatif (4)

Nom du champ	Type de données	Description
`MethodID`	`win:UInt64`	Identificateur unique d’une méthode. Pour les méthodes d'assistance JIT, sa valeur correspond à l'adresse de début de la méthode.
`ModuleID`	`win:UInt64`	Identificateur du module auquel cette méthode appartient (0 pour les programmes d'assistance JIT).
`MethodStartAddress`	`win:UInt64`	Adresse de début de la méthode.
`MethodSize`	`win:UInt32`	Taille de la méthode.
`MethodToken`	`win:UInt32`	0 pour les méthodes dynamiques et les programmes d'assistance JIT.
`MethodFlags`	`win:UInt32`	0x1 : méthode dynamique. 0x2 : méthode générique. 0x4 : méthode de code compilé juste-à-temps (JIT) (ou code d'image natif NGEN). 0x8 : méthode d'assistance.
`ReJITID`	`win:UInt64`	ID ReJIT de la méthode.
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Événement R2RGetEntryPoint

Événement	ID de l’événement	Description
`R2RGetEntryPoint`	159	Déclenché lorsqu’une recherche de point d’entrée R2R se termine.

Mot clé pour déclencher l'événement	Level
`CompilationDiagnosticKeyword`(0x2000000000)	Informatif (4)

Nom du champ	Type de données	Description
`MethodID`	`win:UInt64`	Identificateur unique d’une méthode R2R.
`MethodNamespace`	`win:UnicodeString`	L’espace de noms de la méthode en cours de recherche.
`MethodName`	`win:UnicodeString`	Le nom de la méthode est en cours de recherche.
`MethodSignature`	`win:UnicodeString`	Signature de la méthode (liste de noms de types séparés par des virgules).
`EntryPoint`	`win:UInt64`	Le pointeur vers le point d’entrée de la méthode R2R
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Événement R2RGetEntryPointStart

Événement	ID de l’événement	Description
`R2RGetEntryPointStart`	160	Déclenché lorsqu’une recherche de point d’entrée R2R commence.

Mot clé pour déclencher l'événement	Level
`CompilationDiagnosticKeyword`(0x2000000000)	Informatif (4)

Nom du champ	Type de données	Description
`MethodID`	`win:UInt64`	Identificateur unique d’une méthode R2R.
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Événement MethodLoadVerbose_V1

Événement	ID de l’événement	Description
`MethodLoadVerbose_V1`	143	Déclenché quand une méthode est chargée juste-à-temps (JIT) ou quand une image NGEN est chargée. Les méthodes dynamiques et génériques utilisent toujours cette version pour les chargements de méthodes. Les programmes d'assistance JIT utilisent toujours cette version.

Mot clé pour déclencher l'événement	Level
`JITKeyword` (0x10)	Informatif (4)
`NGenKeyword` (0x20)	Informatif (4)

Nom du champ	Type de données	Description
`MethodID`	`win:UInt64`	Identificateur unique de la méthode. Pour les méthodes d'assistance JIT, sa valeur correspond à l'adresse de début de la méthode.
`ModuleID`	`win:UInt64`	Identificateur du module auquel cette méthode appartient (0 pour les programmes d'assistance JIT).
`MethodStartAddress`	`win:UInt64`	Adresse de début.
`MethodSize`	`win:UInt32`	Longueur de la méthode.
`MethodToken`	`win:UInt32`	0 pour les méthodes dynamiques et les programmes d'assistance JIT.
`MethodFlags`	`win:UInt32`	0x1 : méthode dynamique. 0x2 : méthode générique. 0x4 : méthode compilée juste-à-temps (JIT) (ou générée par NGen.exe) 0x8 : méthode d'assistance.
`MethodNameSpace`	`win:UnicodeString`	Nom d'espace de noms complet associé à la méthode.
`MethodName`	`win:UnicodeString`	Nom complet de classe associé à la méthode.
`MethodSignature`	`win:UnicodeString`	Signature de la méthode (liste de noms de types séparés par des virgules).
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Événement MethodLoadVerbose_V2

Événement	ID de l’événement	Description
`MethodLoadVerbose_V1`	143	Déclenché quand une méthode est chargée juste-à-temps (JIT) ou quand une image NGEN est chargée. Les méthodes dynamiques et génériques utilisent toujours cette version pour les chargements de méthodes. Les programmes d'assistance JIT utilisent toujours cette version.

Mot clé pour déclencher l'événement	Level
`JITKeyword` (0x10)	Informatif (4)
`NGenKeyword` (0x20)	Informatif (4)

Nom du champ	Type de données	Description
`MethodID`	`win:UInt64`	Identificateur unique de la méthode. Pour les méthodes d'assistance JIT, sa valeur correspond à l'adresse de début de la méthode.
`ModuleID`	`win:UInt64`	Identificateur du module auquel cette méthode appartient (0 pour les programmes d'assistance JIT).
`MethodStartAddress`	`win:UInt64`	Adresse de début.
`MethodSize`	`win:UInt32`	Longueur de la méthode.
`MethodToken`	`win:UInt32`	0 pour les méthodes dynamiques et les programmes d'assistance JIT.
`MethodFlags`	`win:UInt32`	0x1 : méthode dynamique. 0x2 : méthode générique. 0x4 : méthode compilée juste-à-temps (JIT) (ou générée par NGen.exe) 0x8 : méthode d'assistance.
`MethodNameSpace`	`win:UnicodeString`	Nom d'espace de noms complet associé à la méthode.
`MethodName`	`win:UnicodeString`	Nom complet de classe associé à la méthode.
`MethodSignature`	`win:UnicodeString`	Signature de la méthode (liste de noms de types séparés par des virgules).
`ReJITID`	`win:UInt64`	ID ReJIT de la méthode.
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Événement MethodUnLoadVerbose_V1

Événement	ID de l’événement	Description
`MethodUnLoadVerbose_V1`	144	Déclenché quand une méthode dynamique est détruite, quand un module est déchargé ou quand un domaine d'application est détruit. Les méthodes dynamiques utilisent toujours cette version pour les déchargements de méthodes.

Mot clé pour déclencher l'événement	Level
`JITKeyword` (0x10)	Informatif (4)
`NGenKeyword` (0x20)	Informatif (4)

Nom du champ	Type de données	Description
`MethodID`	`win:UInt64`	Identificateur unique de la méthode. Pour les méthodes d'assistance JIT, sa valeur correspond à l'adresse de début de la méthode.
`ModuleID`	`win:UInt64`	Identificateur du module auquel cette méthode appartient (0 pour les programmes d'assistance JIT).
`MethodStartAddress`	`win:UInt64`	Adresse de début.
`MethodSize`	`win:UInt32`	Longueur de la méthode.
`MethodToken`	`win:UInt32`	0 pour les méthodes dynamiques et les programmes d'assistance JIT.
`MethodFlags`	`win:UInt32`	0x1 : méthode dynamique. 0x2 : méthode générique. 0x4 : méthode compilée juste-à-temps (JIT) (ou générée par NGen.exe) 0x8 : méthode d'assistance.
`MethodNameSpace`	`win:UnicodeString`	Nom d'espace de noms complet associé à la méthode.
`MethodName`	`win:UnicodeString`	Nom complet de classe associé à la méthode.
`MethodSignature`	`win:UnicodeString`	Signature de la méthode (liste de noms de types séparés par des virgules).
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Événement MethodUnLoadVerbose_V2

Événement	ID de l’événement	Description
`MethodUnLoadVerbose_V2`	144	Déclenché quand une méthode dynamique est détruite, quand un module est déchargé ou quand un domaine d'application est détruit. Les méthodes dynamiques utilisent toujours cette version pour les déchargements de méthodes.

Mot clé pour déclencher l'événement	Level
`JITKeyword` (0x10)	Informatif (4)
`NGenKeyword` (0x20)	Informatif (4)

Nom du champ	Type de données	Description
`MethodID`	`win:UInt64`	Identificateur unique de la méthode. Pour les méthodes d'assistance JIT, sa valeur correspond à l'adresse de début de la méthode.
`ModuleID`	`win:UInt64`	Identificateur du module auquel cette méthode appartient (0 pour les programmes d'assistance JIT).
`MethodStartAddress`	`win:UInt64`	Adresse de début.
`MethodSize`	`win:UInt32`	Longueur de la méthode.
`MethodToken`	`win:UInt32`	0 pour les méthodes dynamiques et les programmes d'assistance JIT.
`MethodFlags`	`win:UInt32`	0x1 : méthode dynamique. 0x2 : méthode générique. 0x4 : méthode compilée juste-à-temps (JIT) (ou générée par NGen.exe) 0x8 : méthode d'assistance.
`MethodNameSpace`	`win:UnicodeString`	Nom d'espace de noms complet associé à la méthode.
`MethodName`	`win:UnicodeString`	Nom complet de classe associé à la méthode.
`MethodSignature`	`win:UnicodeString`	Signature de la méthode (liste de noms de types séparés par des virgules).
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.
`ReJITID`	`win:UInt64`	ID ReJIT de la méthode.

Événement MethodJittingStarted_V1

Le tableau suivant montre les mots clés et les niveaux.

Mot clé pour déclencher l'événement	Level
`JITKeyword` (0x10)	Détaillé (5)
`NGenKeyword` (0x20)	Détaillé (5)

Événement	ID de l’événement	Description
`MethodJittingStarted_V1`	145	Déclenché quand une méthode est compilée juste-à-temps (JIT).

Nom du champ	Type de données	Description
`MethodID`	`win:UInt64`	Identificateur unique de la méthode.
`ModuleID`	`win:UInt64`	Identificateur du module auquel cette méthode appartient.
`MethodToken`	`win:UInt32`	0 pour les méthodes dynamiques et les programmes d'assistance JIT.
`MethodILSize`	`win:UInt32`	Taille du Common Intermediate Language (CIL) pour la méthode qui est compilée juste-à-temps.
`MethodNameSpace`	`win:UnicodeString`	Nom complet de classe associé à la méthode.
`MethodName`	`win:UnicodeString`	Nom de la méthode.
`MethodSignature`	`win:UnicodeString`	Signature de la méthode (liste de noms de types séparés par des virgules).
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Événement MethodJitInliningSucceeded

Mot clé pour déclencher l'événement	Level
`JITTracingKeyword` (0x1000)	Détaillé (5)

Événement	ID de l’événement	Description
`MethodJitInliningSucceeded`	185	Déclenché lorsqu’une méthode est correctement remplacée par le compilateur JIT.

Nom du champ	Type de données	Description
`MethodBeingCompiledNamespace`	`win:UnicodeString`	Espace de noms de la méthode en cours de compilation.
`MethodBeingCompiledName`	`win:UnicodeString`	Nom de la méthode en cours de compilation.
`MethodBeingCompiledNameSignature`	`win:UnicodeString`	Signature de la méthode (liste de noms de types séparés par des virgules) en cours de compilation.
`InlinerNamespace`	`win:UnicodeString`	L’espace de noms de la méthode inliner (« parent »).
`InlinerName`	`win:UnicodeString`	Nom de la méthode inliner (« parent »).
`InlinerNameSignature`	`win:UnicodeString`	Signature de la méthode inliner (« parent ») (liste de noms de types séparés par des virgules).
`InlineeNamespace`	`win:UnicodeString`	L’espace de noms de la méthode inlinee (« enfant»).
`InlineeName`	`win:UnicodeString`	Nom de la méthode inlinee (« enfant »).
`InlineeNameSignature`	`win:UnicodeString`	Signature de la méthode inlinee (« enfant») (liste de noms de types séparés par des virgules).
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Événement MethodJitInliningFailed

Mot clé pour déclencher l'événement	Level
`JITTracingKeyword` (0x1000)	Détaillé (5)

Événement	ID de l’événement	Description
`MethodJitInliningFailed`	192	Déclenché lorsqu’une méthode n’a pas pu être remplacée par le compilateur JIT.

Nom du champ	Type de données	Description
`MethodBeingCompiledNamespace`	`win:UnicodeString`	Espace de noms de la méthode en cours de compilation.
`MethodBeingCompiledName`	`win:UnicodeString`	Nom de la méthode en cours de compilation.
`MethodBeingCompiledNameSignature`	`win:UnicodeString`	Signature de la méthode (liste de noms de types séparés par des virgules) en cours de compilation.
`InlinerNamespace`	`win:UnicodeString`	L’espace de noms de la méthode inliner (« parent »).
`InlinerName`	`win:UnicodeString`	Nom de la méthode inliner (« parent »).
`InlinerNameSignature`	`win:UnicodeString`	Signature de la méthode inliner (« parent ») (liste de noms de types séparés par des virgules).
`InlineeNamespace`	`win:UnicodeString`	L’espace de noms de la méthode inlinee (« enfant»).
`InlineeName`	`win:UnicodeString`	Nom de la méthode inlinee (« enfant »).
`InlineeNameSignature`	`win:UnicodeString`	Signature de la méthode inlinee (« enfant») (liste de noms de types séparés par des virgules).
`FailAlways`	`win:Boolean`	Indique si la méthode est marquée comme non inlinable.
`FailReason`	`win:UnicodeString`	La raison de l’inlining a échoué.
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Événement MethodJITTailCallSucceeded

Mot clé pour déclencher l'événement	Level
`JITTracingKeyword` (0x1000)	Détaillé (5)

Événement	ID de l’événement	Description
`MethodJitTailCallSucceeded`	192	Déclenché par le compilateur JIT lorsqu’une méthode a pu être appelée avec succès à la fin.

Nom du champ	Type de données	Description
`MethodBeingCompiledNamespace`	`win:UnicodeString`	Espace de noms de la méthode en cours de compilation.
`MethodBeingCompiledName`	`win:UnicodeString`	Nom de la méthode en cours de compilation.
`MethodBeingCompiledNameSignature`	`win:UnicodeString`	Signature de la méthode (liste de noms de types séparés par des virgules) en cours de compilation.
`CallerNamespace`	`win:UnicodeString`	Espace de noms de la méthode de l’appelant.
`CallerName`	`win:UnicodeString`	Nom de la méthode de l’appelant.
`CallerNameSignature`	`win:UnicodeString`	Signature de la méthode de l’appelant (liste de noms de types séparés par des virgules).
`CalleeNamespace`	`win:UnicodeString`	Espace de noms de la méthode de l’appelé.
`CalleeName`	`win:UnicodeString`	Nom de la méthode de l’appelé.
`CalleeNameSignature`	`win:UnicodeString`	Signature de la méthode de l’appelé (liste de noms de types séparés par des virgules).
`TailPrefix`	`win:Boolean`	Indique s’il s’agit d’une instruction de préfixe de fin.
`TailCallType`	`win:UInt32`	Le type d’appel de fin. 0 : Appel de fin optimisé (épilogue + jmp) 1 : Appel de fin récursif (la fin de la méthode appelle elle-même) 2 : Appel de fin assisté de l’assistance
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Événement MethodJITTailCallFailed

Mot clé pour déclencher l'événement	Level
`JITTracingKeyword` (0x1000)	Détaillé (5)

Événement	ID de l’événement	Description
`MethodJitTailCallFailed`	191	Déclenché par le compilateur JIT quand une méthode n’a pas pu être appelée à la fin.

Nom du champ	Type de données	Description
`MethodBeingCompiledNamespace`	`win:UnicodeString`	Espace de noms de la méthode en cours de compilation.
`MethodBeingCompiledName`	`win:UnicodeString`	Nom de la méthode en cours de compilation.
`MethodBeingCompiledNameSignature`	`win:UnicodeString`	Signature de la méthode (liste de noms de types séparés par des virgules) en cours de compilation.
`CallerNamespace`	`win:UnicodeString`	Espace de noms de la méthode de l’appelant.
`CallerName`	`win:UnicodeString`	Nom de la méthode de l’appelant.
`CallerNameSignature`	`win:UnicodeString`	Signature de la méthode de l’appelant (liste de noms de types séparés par des virgules).
`CalleeNamespace`	`win:UnicodeString`	Espace de noms de la méthode de l’appelé.
`CalleeName`	`win:UnicodeString`	Nom de la méthode de l’appelé.
`CalleeNameSignature`	`win:UnicodeString`	Signature de la méthode de l’appelé (liste de noms de types séparés par des virgules).
`TailPrefix`	`win:Boolean`	Indique s’il s’agit d’une instruction de préfixe de fin.
`FailReason`	`win:UnicodeString`	La raison de l’appel de fin a échoué.
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Événement MethodILToNativeMap

Mot clé pour déclencher l'événement	Level
`JittedMethodILToNativeMapKeyword` (0x20000)	Détaillé (5)

Événement	ID de l’événement	Description
`MethodILToNativeMap`	190	Mappe l’événement de mappage IL-to-native pour les méthodes compilées par JIT.

Nom du champ	Type de données	Description
`MethodID`	`win:UInt64`	Identificateur unique d’une méthode.
`ReJITID`	`win:UInt64`	L’ID ReJIT de la méthode.
`MethodExtent`	`win:UInt8`	L’étendue de la méthode jitted.
`CountOfMapEntries`	`win:UInt16`	Nombre d’entrées de mappage
`ILOffsets`	`win:UInt32`	Décalage IL.
`NativeOffsets`	`win:UInt32`	Le décalage de code natif.
`ClrInstanceID`	`win:UInt16`	ID unique de l’instance de CoreCLR.

Partager via