Événements ETW de garbage collection

Ces événements collectent des informations relatives au garbage collection. Ils facilitent le diagnostic et le débogage, et permettent notamment de déterminer le nombre de fois où un garbage collection a été exécuté, la quantité de mémoire libérée pendant l'opération, etc.

Cette catégorie se compose des événements suivants :

• Événement GCStart_V1

• Événement GCEnd_V1

• Événement GCHeapStats_V1

• Événement GCCreateSegment_V1

• Événement GCFreeSegment_V1

• Événement GCRestartEEBegin_V1

• Événement GCRestartEEEnd_V1

• Événement GCSuspendEE_V1

• Événement GCSuspendEEEnd_V1

• Événement GCAllocationTick_V1

• Événement GCFinalizersBegin_V1

• Événement GCFinalizersEnd_V1

• Événement GCCreateConcurrentThread_V1

• Événement GCTerminateConcurrentThread_V1

Événement GCStart_V1

Le tableau suivant indique le mot clé et le niveau. (Pour plus d'informations consultez Niveaux et mots clés ETW du CLR.)

Mot clé destiné à déclencher l'événement.	Niveau
GCKeyword (0x1)	Informations (4)

Le tableau suivant indique les informations d'événement.

Événement	ID d'événement	Déclenché lorsque
GCStart_V1	1	Un garbage collection a démarré.

Le tableau suivant répertorie les données d'événement.

Nom du champ	Type de données	Description
Count	win:UInt32	Nième garbage collection.
Depth	win:UInt32	Génération en cours de collection.
Motif	win:UInt32	Pourquoi le garbage collection a été déclenché : 0x0 - Allocation du tas de petits objets. 0x1 - Induit. 0x2 - Mémoire faible. 0x3 - Vide. 0x4 - Allocation du tas d'objets volumineux. 0x5 - Espace insuffisant (pour le tas de petits objets). 0x6 - Espace insuffisant (pour le tas d'objets volumineux).
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 pour l'instance de CLR ou CoreCLR.

Retour au début

Événement GCEnd_V1

Le tableau suivant indique le mot clé et le niveau.

Mot clé destiné à déclencher l'événement.	Niveau
GCKeyword (0x1)	Informations (4)

Le tableau suivant indique les informations d'événement.

Événement	ID d'événement	Déclenché lorsque
GCEnd_V1	2	Le garbage collection est terminé.

Le tableau suivant répertorie les données d'événement.

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

Retour au début

Événement GCHeapStats_V1

Le tableau suivant indique le mot clé et le niveau.

Mot clé destiné à déclencher l'événement.	Niveau
GCKeyword (0x1)	Informations (4)

Le tableau suivant indique les informations d'événement.

Événement	ID d'événement	Description
GCHeapStats_V1	4	Affiche les statistiques de tas à la fin de chaque garbage collection.

Le tableau suivant répertorie les données d'événement.

Nom du champ	Type de données	Description
GenerationSize0	win:UInt64	Taille, en octets, de la mémoire de la 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 la 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 la génération 2.
TotalPromotedSize2	win:UInt64	Nombre d'octets qui ont survécu dans la génération 2 après la dernière collection.
GenerationSize3	win:UInt64	Taille, en octets, du tas d'objets volumineux.
TotalPromotedSize3	win:UInt64	Nombre d'octets qui ont survécu dans le tas d'objets volumineux après la dernière collecte.
FinalizationPromotedSize	win:UInt64	Taille totale, en octets, des objets qui sont prêts pour la finalisation.
FinalizationPromotedCount	win:UInt64	Nombre d'objets qui sont prêts pour la finalisation.
PinnedObjectCount	win:UInt32	Nombre d'objets épinglés (non déplaçables).
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 pour l'instance de CLR ou CoreCLR.

Retour au début

Événement GCCreateSegment_V1

Le tableau suivant indique le mot clé et le niveau.

Mot clé destiné à déclencher l'événement.	Niveau
GCKeyword (0x1)	Informations (4)

Le tableau suivant indique les informations d'événement.

Événement	ID d'événement	Déclenché lorsque
GCCreateSegment_V1	5	Un nouveau segment de garbage collection a été créé. De plus, lorsque le traçage est activé sur un processus qui s'exécute déjà, cet événement est déclenché pour chaque segment existant.

Le tableau suivant répertorie les données d'événement.

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 pour l'instance de CLR ou CoreCLR.

Retour au début

Événement GCFreeSegment_V1

Le tableau suivant indique le mot clé et le niveau.

Mot clé destiné à déclencher l'événement.	Niveau
GCKeyword (0x1)	Informations (4)

Le tableau suivant indique les informations d'événement.

Événement	ID d'événement	Déclenché lorsque
GCFreeSegment_V1	6	Un segment de garbage collection a été libéré.

Le tableau suivant répertorie les données d'événement.

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

Retour au début

Événement GCRestartEEBegin_V1

Le tableau suivant indique le mot clé et le niveau.

Mot clé destiné à déclencher l'événement.	Niveau
GCKeyword (0x1)	Informations (4)

Le tableau suivant indique les informations d'événement.

Événement	ID d'événement	Déclenché lorsque
GCRestartEEBegin_V1	7	Le rétablissement après suspension du Common Language Runtime a commencé.

Pas de données d'événement.

Retour au début

Événement GCRestartEEEnd_V1

Le tableau suivant indique le mot clé et le niveau.

Mot clé destiné à déclencher l'événement.	Niveau
GCKeyword (0x1)	Informations (4)

Le tableau suivant indique les informations d'événement.

Événement	ID d'événement	Déclenché lorsque
GCRestartEEEnd_V1	3	Le rétablissement après suspension du Common Language Runtime est terminé.

Pas de données d'événement.

Retour au début

Événement GCSuspendEE_V1

Le tableau suivant indique le mot clé et le niveau.

Mot clé destiné à déclencher l'événement.	Niveau
GCKeyword (0x1)	Informations (4)

Le tableau suivant indique les informations d'événement.

Événement	ID d'événement	Déclenché lorsque
GCSuspendEE_V1	9	Début de la suspension du moteur d'exécution pour le garbage collection.

Le tableau suivant répertorie les données d'événement.

Nom du champ	Type de données	Description
Motif	win:UInt16	0x0 - Autre. 0x1 - Garbage collection. 0x2 - Fermeture du domaine d'application. 0x3 - Suspension de code. 0x4 - Arrêt. 0x5 - Débogueur. 0x6 - Préparation du garbage collection.
Count	win:UInt32	Nombre de threads suspendus.
ClrInstanceID	win:UInt16	ID unique pour l'instance de CLR ou CoreCLR.

Retour au début

Événement GCSuspendEEEnd_V1

Le tableau suivant indique le mot clé et le niveau :

Mot clé destiné à déclencher l'événement.	Niveau
GCKeyword (0x1)	Informations (4)

Le tableau suivant affiche les informations sur les événements :

Événement	ID d'événement	Déclenché lorsque
GCSuspendEEEnd_V1	8	Fin de la suspension du moteur d'exécution pour le garbage collection.

Pas de données d'événement.

Retour au début

Événement GCAllocationTick_V1

Le tableau suivant indique le mot clé et le niveau.

Mot clé destiné à déclencher l'événement.	Niveau
GCKeyword (0x1)	Informations (4)

Le tableau suivant indique les informations d'événement.

Événement	ID d'événement	Déclenché lorsque
GCAllocationTick_V1	10	Chaque fois qu'environ 100 Ko sont alloués.

Le tableau suivant répertorie les données d'événement.

Nom du champ	Type de données	Description
AllocationSize	win:UInt32	Taille de l'allocation.
Genre	win:UInt32	0x0 - Allocation de petits objets (l'allocation est dans le tas de petits objets). 0x1 - Allocation d'objets volumineux (l'allocation est dans le tas d'objets volumineux).
ClrInstanceID	win:UInt16	ID unique pour l'instance de CLR ou CoreCLR.

Retour au début

Événement GCFinalizersBegin_V1

Le tableau suivant indique le mot clé et le niveau.

Mot clé destiné à déclencher l'événement.	Niveau
GCKeyword (0x1)	Informations (4)

Le tableau suivant indique les informations d'événement.

Événement	ID d'événement	Déclenché lorsque
GCFinalizersBegin_V1	14	Démarrage de l'exécution des finaliseurs.

Pas de données d'événement.

Retour au début

Événement GCFinalizersEnd_V1

Le tableau suivant indique le mot clé et le niveau.

Mot clé destiné à déclencher l'événement.	Niveau
GCKeyword (0x1)	Informations (4)

Le tableau suivant indique les informations d'événement.

Événement	ID d'événement	Déclenché lorsque
GCFinalizersEnd_V1	13	Fin de l'exécution des finaliseurs.

Le tableau suivant répertorie les données d'événement.

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

Retour au début

Événement GCCreateConcurrentThread_V1

Le tableau suivant indique le mot clé et le niveau.

Mot clé destiné à déclencher l'événement.	Niveau
GCKeyword (0x1)	Informations (4)
ThreadingKeyword (0x10000)	Informations (4)

Le tableau suivant indique les informations d'événement.

Événement	ID d'événement	Déclenché lorsque
GCCreateConcurrentThread_V1	11	Le thread de garbage collection simultané a été créé.

Pas de données d'événement.

Retour au début

Événement GCTerminateConcurrentThread_V1

Le tableau suivant indique le mot clé et le niveau.

Mot clé destiné à déclencher l'événement.	Niveau
GCKeyword (0x1)	Informations (4)
ThreadingKeyword (0x10000)	Informations (4)

Le tableau suivant indique les informations d'événement.

Événement	ID d'événement	Déclenché lorsque
GCTerminateConcurrentThread_V1	12	Le thread de garbage collection simultané a été arrêté.

Pas de données d'événement.

Retour au début

Voir aussi

Concepts

Événements ETW du CLR

Historique des modifications

Date	Historique	Motif
Août 2010	Les informations de type pour l'événement GCStart_V1 ont été corrigées.	Résolution des bogues de contenu.