Partager via


Événements ETW de garbage collection

Ces événements collectent des informations relatives au garbage collection. Ils vous aident dans le diagnostic et le débogage, y compris pour déterminer combien de fois le garbage collection a été effectué, la quantité de mémoire libérée pendant le garbage collection, etc.

Cette catégorie comprend les événements suivants :

Événement GCStart_V1

Le tableau suivant montre les mots clés et les niveaux. Pour plus d’informations, consultez Mots clés et niveaux ETW du CLR.

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)

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

Événement ID de l’événement Moment du déclenchement
GCStart_V1 1 Un garbage collection a démarré.

Le tableau ci-dessous montre les données d’événements.

Nom du champ Type de données Description
Count win:UInt32 Le nième garbage collection.
Profondeur win:UInt32 La génération est collectée.
Motif win:UInt32 Pourquoi le garbage collection a été déclenché :

0x0 – Allocation de tas de petits objets.

0x1 – Induit.

0x2 – Mémoire insuffisante.

0x3 – Vide.

0x4 – Allocation de tas d'objets volumineux.

0x5 – Espace insuffisant (pour un tas de petits objets)

0x6 – Espace insuffisant (pour un tas d'objets volumineux)

0x7 – Induit mais non forcé comme blocage

0x8 - Test de contrainte.

0x9 - Le thread de finaliseur a observé que le processus manque de mémoire et a provoqué un nettoyage de la mémoire.

0x10 - Le code utilisateur a provoqué un nettoyage de la mémoire et a demandé que celui-ci soit un nettoyage avec compactage.
Type win:UInt32 0x0 – Un blocage de garbage collection s'est produit en dehors du garbage collection d'arrière-plan.

0x1 – Garbage collection d'arrière-plan.

0x2 – Un blocage de garbage collection s'est produit pendant le garbage collection d'arrière-plan.
ClrInstanceID win:UInt16 ID unique de l'instance de CLR ou CoreCLR.

Événement GCEnd_V1

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)

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

Événement ID de l’événement Moment du déclenchement
GCEnd_V1 2 Un garbage collection s'est terminé.

Le tableau ci-dessous montre les données d’événements.

Nom du champ Type de données Description
Count win:UInt32 Le nième garbage collection.
Profondeur win:UInt32 Génération ayant été collectée.
ClrInstanceID win:UInt16 ID unique de l'instance de CLR ou CoreCLR.

Événement GCHeapStats_V1

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)

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

Événement ID de l’événement Description
GCHeapStats_V1 4 Affiche les statistiques relatives aux tas à la fin de chaque garbage collection.

Le tableau ci-dessous montre les données d’événements.

Nom du champ Type de données Description
GenerationSize0 win:UInt64 Taille, en octets, de la mémoire de génération 0.
TotalPromotedSize0 win:UInt64 Nombre d'octets promus de la génération 0 à la génération 1.
GenerationSize1 win:UInt64 Taille, en octets, de la mémoire de génération 1.
TotalPromotedSize1 win:UInt64 Nombre d'octets promus de la génération 1 à la génération 2.
GenerationSize2 win:UInt64 Taille, en octets, de la mémoire de génération 2.
TotalPromotedSize2 win:UInt64 Nombre d'octets ayant survécu dans la génération 2 après la dernière collection.
GenerationSize3 win:UInt64 Taille, en octets, du tas des objets volumineux.
TotalPromotedSize3 win:UInt64 Nombre d'octets ayant survécu dans le tas d'objets volumineux après la dernière collection.
FinalizationPromotedSize win:UInt64 Taille totale, en octets, des objets qui sont prêts pour la finalisation.
FinalizationPromotedSize win:UInt64 Nombre d'objets qui sont prêts pour la finalisation.
PinnedObjectCount win:UInt32 Nombre d'objets (non déplaçables) épinglés.
SinkBlockCount win:UInt32 Nombre de blocs de synchronisation en cours d'utilisation.
GCHandleCount win:UInt32 Nombre de handles de garbage collection en cours d'utilisation.
ClrInstanceID win:UInt16 ID unique de l'instance de CLR ou CoreCLR.

Événement GCHeapStats_V2

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)

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

Événement ID de l’événement Description
GCHeapStats_V2 4 Affiche les statistiques relatives aux tas à la fin de chaque garbage collection.

Le tableau ci-dessous montre les données d’événements.

Nom du champ Type de données Description
GenerationSize0 win:UInt64 Taille, en octets, de la mémoire de génération 0.
TotalPromotedSize0 win:UInt64 Nombre d'octets promus de la génération 0 à la génération 1.
GenerationSize1 win:UInt64 Taille, en octets, de la mémoire de génération 1.
TotalPromotedSize1 win:UInt64 Nombre d'octets promus de la génération 1 à la génération 2.
GenerationSize2 win:UInt64 Taille, en octets, de la mémoire de génération 2.
TotalPromotedSize2 win:UInt64 Nombre d'octets ayant survécu dans la génération 2 après la dernière collection.
GenerationSize3 win:UInt64 Taille, en octets, du tas des objets volumineux.
TotalPromotedSize3 win:UInt64 Nombre d'octets ayant survécu dans le tas d'objets volumineux après la dernière collection.
FinalizationPromotedSize win:UInt64 Taille totale, en octets, des objets qui sont prêts pour la finalisation.
FinalizationPromotedSize win:UInt64 Nombre d'objets qui sont prêts pour la finalisation.
PinnedObjectCount win:UInt32 Nombre d'objets (non déplaçables) épinglés.
SinkBlockCount win:UInt32 Nombre de blocs de synchronisation en cours d'utilisation.
GCHandleCount win:UInt32 Nombre de handles de garbage collection en cours d'utilisation.
ClrInstanceID win:UInt16 ID unique de l'instance de CLR ou CoreCLR.
GenerationSize4 win:UInt64 Taille en octets du tas des objets épinglés.
TotalPromotedSize4 win:UInt64 Nombre d’octets ayant survécu dans le tas des objets épinglés après le dernier nettoyage.

Événement GCCreateSegment_V1

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)

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

Événement ID de l’événement Moment du déclenchement
GCCreateSegment_V1 5 Un nouveau segment de garbage collection a été créé. En outre, quand le suivi est activé sur un processus en cours d'exécution, cet événement est déclenché pour chaque segment existant.

Le tableau ci-dessous montre les données d’événements.

Nom du champ Type de données Description
Adresse win:UInt64 Adresse du segment.
Taille win:UInt64 Taille du segment.
Type win:UInt32 0x0 – Tas de petits objets.

0x1 – Tas d'objets volumineux.

0x2 – Tas en lecture seule.
ClrInstanceID win:UInt16 ID unique de l'instance de CLR ou CoreCLR.

Notez que la taille des segments alloués par le garbage collector est spécifique à l'implémentation et susceptible de changer à tout moment, y compris lors des mises à jour périodiques. Votre application ne doit jamais faire d'hypothèses concernant une taille de segment particulière, ni dépendre de celle-ci. Elle ne doit pas non plus tenter de configurer la quantité de mémoire disponible pour les allocations de segments.

Événement GCFreeSegment_V1

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)

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

Événement ID de l’événement Moment du déclenchement
GCFreeSegment_V1 6 Un nouveau segment de garbage collection a été libéré.

Le tableau ci-dessous montre les données d’événements.

Nom du champ Type de données Description
Adresse win:UInt64 Adresse du segment.
ClrInstanceID win:UInt16 ID unique de l'instance de CLR ou CoreCLR.

Événement GCRestartEEBegin_V1

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)

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

Événement ID de l’événement Moment du déclenchement
GCRestartEEBegin_V1 7 La reprise du common language runtime après sa suspension a commencé.

Aucune donnée d'événement.

Événement GCRestartEEEnd_V1

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)

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

Événement ID d'événement Moment du déclenchement
GCRestartEEEnd_V1 3 La reprise du common language runtime après sa suspension s'est terminée.

Aucune donnée d'événement.

Événement GCSuspendEE_V1

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)

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

Événement ID de l’événement Moment du déclenchement
GCSuspendEE_V1 9 Début de la suspension du moteur d'exécution pour le garbage collection.

Le tableau ci-dessous montre les données d’événements.

Nom du champ Type de données Description
Raison win:UInt16 0x0 – Autre.

0x1 – Garbage collection.

0x2 – Fermeture du domaine d'application.

0x3 – Pitching de code.

0x4 – Arrêt.

0x5 – Débogueur.

0x6 – Préparation pour le garbage collection.
Count win:UInt32 Nombre GC à ce moment-là. En règle générale, vous verrez un événement de démarrage de GC par la suite et son nombre doit être égal à ce nombre + 1 à mesure que nous augmentons l’index GC pendant un garbage collection.
ClrInstanceID win:UInt16 ID unique de l'instance de CLR ou CoreCLR.

Événement GCSuspendEEEnd_V1

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)

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

Événement ID de l’événement Moment du déclenchement
GCSuspendEEEnd_V1 8 Fin de la suspension du moteur d'exécution pour le garbage collection.

Aucune donnée d'événement.

Événement GCAllocationTick_V2

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)

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

Événement ID de l’événement Moment du déclenchement
GCAllocationTick_V2 10 Chaque fois qu’environ 100 Ko sont alloués par tas d’objets. Autrement dit, SOH, LOH et POH accumulent séparément leurs octets alloués. Dans le serveur GC, cette opération est effectuée par segment de mémoire.

Le tableau ci-dessous montre les données d’événements.

Nom du champ Type de données Description
AllocationAmount win:UInt32 Taille de l'allocation, en octets. Cette valeur est correcte pour les allocations inférieures à la longueur d'un ULONG (4 294 967 295 octets). Si l'allocation est supérieure, ce champ contient une valeur tronquée. Utilisez AllocationAmount64 pour les allocations très volumineuses.
AllocationKind win:UInt32 0x0 – Allocation de petits objets (l'allocation se fait dans le tas de petits objets).
0x1 – Allocation d'objets volumineux (l'allocation se fait dans le tas des objets volumineux).
0x2 - Allocation d’objets épinglés (l’allocation est dans le tas d’objets épinglé).
ClrInstanceID win:UInt16 ID unique de l'instance de CLR ou CoreCLR.
AllocationAmount64 win:UInt64 Taille de l'allocation, en octets. Cette valeur est correcte pour les allocations très volumineuses.
TypeId win:Pointer Adresse de MethodTable. Quand plusieurs types d'objets ont été alloués au cours de cet événement, il s'agit de l'adresse de MethodTable qui correspond au dernier objet alloué (l'objet qui a provoqué le dépassement du seuil de 100 Ko).
TypeName win:UnicodeString Nom du type ayant été alloué. Quand plusieurs types d'objets ont été alloués au cours de cet événement, il s'agit du type du dernier objet alloué (l'objet qui a provoqué le dépassement du seuil de 100 Ko).
HeapIndex win:UInt32 Segment de mémoire où l'objet a été alloué. Cette valeur est de 0 (zéro) lors d'une exécution avec le garbage collection pour station de travail.

Événement GCAllocationTick_V3

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)

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

Événement ID de l’événement Moment du déclenchement
GCAllocationTick_V2 10 Chaque fois qu’environ 100 Ko sont alloués par tas d’objets. Autrement dit, SOH, LOH et POH accumulent séparément leurs octets alloués. Dans le serveur GC, cette opération est effectuée par segment de mémoire.

Le tableau ci-dessous montre les données d’événements.

Nom du champ Type de données Description
AllocationAmount win:UInt32 Taille de l'allocation, en octets. Cette valeur est correcte pour les allocations inférieures à la longueur d'un ULONG (4 294 967 295 octets). Si l'allocation est supérieure, ce champ contient une valeur tronquée. Utilisez AllocationAmount64 pour les allocations très volumineuses.
AllocationKind win:UInt32 0x0 – Allocation de petits objets (l'allocation se fait dans le tas de petits objets).
0x1 – Allocation d'objets volumineux (l'allocation se fait dans le tas des objets volumineux).
0x2 - Allocation d’objets épinglés (l’allocation est dans le tas d’objets épinglé).
ClrInstanceID win:UInt16 ID unique de l'instance de CLR ou CoreCLR.
AllocationAmount64 win:UInt64 Taille de l'allocation, en octets. Cette valeur est correcte pour les allocations très volumineuses.
TypeId win:Pointer Adresse de MethodTable. Quand plusieurs types d'objets ont été alloués au cours de cet événement, il s'agit de l'adresse de MethodTable qui correspond au dernier objet alloué (l'objet qui a provoqué le dépassement du seuil de 100 Ko).
TypeName win:UnicodeString Nom du type ayant été alloué. Quand plusieurs types d'objets ont été alloués au cours de cet événement, il s'agit du type du dernier objet alloué (l'objet qui a provoqué le dépassement du seuil de 100 Ko).
HeapIndex win:UInt32 Segment de mémoire où l'objet a été alloué. Cette valeur est de 0 (zéro) lors d'une exécution avec le garbage collection pour station de travail.
Adresse win:Pointer Adresse du dernier objet alloué.

Événement GCFinalizersBegin_V1

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)

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

Événement ID de l’événement Moment du déclenchement
GCFinalizersBegin_V1 14 Début de l'exécution des finaliseurs.

Aucune donnée d'événement.

Événement GCFinalizersEnd_V1

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)

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

Événement ID de l’événement Moment du déclenchement
GCFinalizersEnd_V1 13 Fin de l'exécution des finaliseurs.

Le tableau ci-dessous montre les données d’événements.

Nom du champ Type de données Description
Count win:UInt32 Nombre de finaliseurs exécutés.
ClrInstanceID win:UInt16 ID unique de l'instance de CLR ou CoreCLR.

Événement GCCreateConcurrentThread_V1

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)
ThreadingKeyword (0x10000) Informatif (4)

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

Événement ID de l’événement Moment du déclenchement
GCCreateConcurrentThread_V1 11 Un thread de garbage collection simultané a été créé.

Aucune donnée d'événement.

Événement GCTerminateConcurrentThread_V1

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

Mot clé pour déclencher l'événement Level
GCKeyword (0x1) Informatif (4)
ThreadingKeyword (0x10000) Informatif (4)

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

Événement ID de l’événement Moment du déclenchement
GCTerminateConcurrentThread_V1 12 Un thread de garbage collection simultané s'est terminé.

Aucune donnée d'événement.

Voir aussi