ガベージ コレクション ETW イベントGarbage Collection ETW Events

これらのイベントは、ガベージ コレクションに関連する情報を収集します。These events collect information pertaining to garbage collection. ガベージ コレクションが実行された回数、ガベージ コレクションの間に解放されたメモリの量など、診断やデバッグに役立つ情報を入手できます。They help in diagnostics and debugging, including determining how many times garbage collection was performed, how much memory was freed during garbage collection, and so on.

このカテゴリは、次のイベントで構成されます。This category consists of the following events:

GCStart_V1 イベントGCStart_V1 Event

次の表に、キーワードとレベルを示します。The following table shows the keyword and level. (詳細については、「 CLR ETW Keywords and Levels」を参照してください)。(For more information, see CLR ETW Keywords and Levels.)

イベントを発生させるキーワードKeyword for raising the event レベルLevel
GCKeyword (0x1)GCKeyword (0x1) 情報提供 (4)Informational (4)

次の表に、イベント情報を示します。The following table shows the event information.

イベントEvent イベント IDEvent ID いつ発生するかRaised when
GCStart_V1 11 ガベージ コレクションが開始されました。A garbage collection has started.

次の表に、イベント データを示します。The following table shows the event data.

フィールド名Field name データ型Data type 説明Description
カウントCount win:UInt32win:UInt32 n回めのガベージ コレクション。The nth garbage collection.
奥行Depth win:UInt32win:UInt32 収集されるジェネレーション。The generation that is being collected.
理由Reason win:UInt32win:UInt32 ガベージ コレクションが発生した理由:Why the garbage collection was triggered:

0x0 - 小さなオブジェクト ヒープの割り当て。0x0 - Small object heap allocation.

0x1 - 強制実行。0x1 - Induced.

0x2 - メモリ不足。0x2 - Low memory.

0x3 - 空。0x3 - Empty.

0x4 - 大きなオブジェクト ヒープの割り当て。0x4 - Large object heap allocation.

0x5 - 領域不足 (小さなオブジェクト ヒープが対象)。0x5 - Out of space (for small object heap).

0x6 - 領域不足 (大きなオブジェクト ヒープが対象)。0x6 - Out of space (for large object heap).

0x7 - 強制実行されるが、ブロッキングとして強制されない。0x7 - Induced but not forced as blocking.
Type win:UInt32win:UInt32 0x0 - バックグラウンド ガベージ コレクションの外部で発生するブロッキング ガベージ コレクション。0x0 - Blocking garbage collection occurred outside background garbage collection.

0x1 - バックグラウンド ガベージ コレクション。0x1 - Background garbage collection.

0x2 - バックグラウンド ガベージ コレクションの実行中に発生するブロッキング ガベージ コレクション。0x2 - Blocking garbage collection occurred during background garbage collection.
ClrInstanceIDClrInstanceID win:UInt16win:UInt16 CLR または CoreCLR のインスタンスの一意の ID。Unique ID for the instance of CLR or CoreCLR.

ページのトップへBack to top

GCEnd_V1 イベントGCEnd_V1 Event

次の表に、キーワードとレベルを示します。The following table shows the keyword and level.

イベントを発生させるキーワードKeyword for raising the event レベルLevel
GCKeyword (0x1)GCKeyword (0x1) 情報提供 (4)Informational (4)

次の表に、イベント情報を示します。The following table shows the event information.

イベントEvent イベント IDEvent ID いつ発生するかRaised when
GCEnd_V1 22 ガベージ コレクションが終了しました。The garbage collection has ended.

次の表に、イベント データを示します。The following table shows the event data.

フィールド名Field name データ型Data type 説明Description
カウントCount win:UInt32win:UInt32 n回めのガベージ コレクション。The nth garbage collection.
奥行Depth win:UInt32win:UInt32 収集されたジェネレーション。The generation that was collected.
ClrInstanceIDClrInstanceID win:UInt16win:UInt16 CLR または CoreCLR のインスタンスの一意の ID。Unique ID for the instance of CLR or CoreCLR.

ページのトップへBack to top

GCHeapStats_V1 イベントGCHeapStats_V1 Event

次の表に、キーワードとレベルを示します。The following table shows the keyword and level.

イベントを発生させるキーワードKeyword for raising the event レベルLevel
GCKeyword (0x1)GCKeyword (0x1) 情報提供 (4)Informational (4)

次の表に、イベント情報を示します。The following table shows the event information.

イベントEvent イベント IDEvent ID 説明Description
GCHeapStats_V1 44 各ガベージ コレクション終了時のヒープの統計情報を示します。Shows the heap statistics at the end of each garbage collection.

次の表に、イベント データを示します。The following table shows the event data.

フィールド名Field name データ型Data type 説明Description
GenerationSize0GenerationSize0 win:UInt64win:UInt64 ジェネレーション 0 メモリのサイズ (バイト単位)。The size, in bytes, of generation 0 memory.
TotalPromotedSize0TotalPromotedSize0 win:UInt64win:UInt64 ジェネレーション 0 からジェネレーション 1 に移されたバイト数。The number of bytes that are promoted from generation 0 to generation 1.
GenerationSize1GenerationSize1 win:UInt64win:UInt64 ジェネレーション 1 メモリのサイズ (バイト単位)。The size, in bytes, of generation 1 memory.
TotalPromotedSize1TotalPromotedSize1 win:UInt64win:UInt64 ジェネレーション 1 からジェネレーション 2 に移されたバイト数。The number of bytes that are promoted from generation 1 to generation 2.
GenerationSize2GenerationSize2 win:UInt64win:UInt64 ジェネレーション 2 メモリのサイズ (バイト単位)。The size, in bytes, of generation 2 memory.
TotalPromotedSize2TotalPromotedSize2 win:UInt64win:UInt64 最後のガベージ コレクションの後にジェネレーション 2 に残ったバイト数。The number of bytes that survived in generation 2 after the last collection.
GenerationSize3GenerationSize3 win:UInt64win:UInt64 大きなオブジェクト ヒープのサイズ (バイト単位)。The size, in bytes, of the large object heap.
TotalPromotedSize3TotalPromotedSize3 win:UInt64win:UInt64 最後のガベージ コレクションの後に大きなオブジェクト ヒープに残ったバイト数。The number of bytes that survived in the large object heap after the last collection.
FinalizationPromotedSizeFinalizationPromotedSize win:UInt64win:UInt64 終了準備が完了しているオブジェクトの合計サイズ (バイト単位)。The total size, in bytes, of the objects that are ready for finalization.
FinalizationPromotedCountFinalizationPromotedCount win:UInt64win:UInt64 終了準備が完了しているオブジェクトの数。The number of objects that are ready for finalization.
PinnedObjectCountPinnedObjectCount win:UInt32win:UInt32 ピン止めオブジェクト (移動できないオブジェクト) の数。The number of pinned (unmovable) objects.
SinkBlockCountSinkBlockCount win:UInt32win:UInt32 使用中の同期ブロックの数。The number of synchronization blocks in use.
GCHandleCountGCHandleCount win:UInt32win:UInt32 使用中のガベージ コレクション ハンドルの数。The number of garbage collection handles in use.
ClrInstanceIDClrInstanceID win:UInt16win:UInt16 CLR または CoreCLR のインスタンスの一意の ID。Unique ID for the instance of CLR or CoreCLR.

ページのトップへBack to top

GCCreateSegment_V1 イベントGCCreateSegment_V1 Event

次の表に、キーワードとレベルを示します。The following table shows the keyword and level.

イベントを発生させるキーワードKeyword for raising the event レベルLevel
GCKeyword (0x1)GCKeyword (0x1) 情報提供 (4)Informational (4)

次の表に、イベント情報を示します。The following table shows the event information.

イベントEvent イベント IDEvent ID いつ発生するかRaised when
GCCreateSegment_V1 55 新しいガベージ コレクション セグメントが作成されました。A new garbage collection segment has been created. 既に実行されているプロセスでトレースを有効にした場合は、このイベントが各既存セグメントについて発生します。In addition, when tracing is enabled on a process that is already running, this event is raised for each existing segment.

次の表に、イベント データを示します。The following table shows the event data.

フィールド名Field name データ型Data type 説明Description
アドレスAddress win:UInt64win:UInt64 セグメントのアドレス。The address of the segment.
サイズSize win:UInt64win:UInt64 セグメントのサイズ。The size of the segment.
Type win:UInt32win:UInt32 0x0 - 小さなオブジェクト ヒープ。0x0 - Small object heap.

0x1 - 大きなオブジェクト ヒープ。0x1 - Large object heap.

0x2 - 読み取り専用ヒープ。0x2 - Read-only heap.
ClrInstanceIDClrInstanceID win:UInt16win:UInt16 CLR または CoreCLR のインスタンスの一意の ID。Unique ID for the instance of CLR or CoreCLR.

ガベージ コレクターによって割り当てられるセグメントのサイズは実装に固有であり、定期的な更新プログラムによる場合を含め、いつでも変更されることがあります。Note that the size of segments allocated by the garbage collector is implementation-specific and is subject to change at any time, including in periodic updates. アプリでは、セグメント サイズを推測することや、特定のセグメント サイズに依存することを絶対に避けてください。また、セグメントの割り当てに使用可能なメモリの量を構成しようとしてもなりません。Your app should never make assumptions about or depend on a particular segment size, nor should it attempt to configure the amount of memory available for segment allocations.

ページのトップへBack to top

GCFreeSegment_V1 イベントGCFreeSegment_V1 Event

次の表に、キーワードとレベルを示します。The following table shows the keyword and level.

イベントを発生させるキーワードKeyword for raising the event レベルLevel
GCKeyword (0x1)GCKeyword (0x1) 情報提供 (4)Informational (4)

次の表に、イベント情報を示します。The following table shows the event information.

イベントEvent イベント IDEvent ID いつ発生するかRaised when
GCFreeSegment_V1 66 ガベージ コレクション セグメントが解放されました。A garbage collection segment has been released.

次の表に、イベント データを示します。The following table shows the event data.

フィールド名Field name データ型Data type 説明Description
アドレスAddress win:UInt64win:UInt64 セグメントのアドレス。The address of the segment.
ClrInstanceIDClrInstanceID win:UInt16win:UInt16 CLR または CoreCLR のインスタンスの一意の ID。Unique ID for the instance of CLR or CoreCLR.

ページのトップへBack to top

GCRestartEEBegin_V1 イベントGCRestartEEBegin_V1 Event

次の表に、キーワードとレベルを示します。The following table shows the keyword and level.

イベントを発生させるキーワードKeyword for raising the event レベルLevel
GCKeyword (0x1)GCKeyword (0x1) 情報提供 (4)Informational (4)

次の表に、イベント情報を示します。The following table shows the event information.

イベントEvent イベント IDEvent ID いつ発生するかRaised when
GCRestartEEBegin_V1 77 共通言語ランタイムの中断からの再開が開始されました。Resumption from common language runtime suspension has begun.

イベント データはありません。No event data.

ページのトップへBack to top

GCRestartEEEnd_V1 イベントGCRestartEEEnd_V1 Event

次の表に、キーワードとレベルを示します。The following table shows the keyword and level.

イベントを発生させるキーワードKeyword for raising the event レベルLevel
GCKeyword (0x1)GCKeyword (0x1) 情報提供 (4)Informational (4)

次の表に、イベント情報を示します。The following table shows the event information.

イベントEvent イベント IDEvent Id いつ発生するかRaised when
GCRestartEEEnd_V1 33 共通言語ランタイムの中断からの再開が終了しました。Resumption from common language runtime suspension has ended.

イベント データはありません。No event data.

ページのトップへBack to top

GCSuspendEE_V1 イベントGCSuspendEE_V1 Event

次の表に、キーワードとレベルを示します。The following table shows the keyword and level.

イベントを発生させるキーワードKeyword for raising the event レベルLevel
GCKeyword (0x1)GCKeyword (0x1) 情報提供 (4)Informational (4)

次の表に、イベント情報を示します。The following table shows the event information.

イベントEvent イベント IDEvent ID いつ発生するかRaised when
GCSuspendEE_V1 99 ガベージ コレクションのための実行エンジンの中断の開始。Start of suspension of the execution engine for garbage collection.

次の表に、イベント データを示します。The following table shows the event data.

フィールド名Field name データ型Data type 説明Description
理由Reason win:UInt16win:UInt16 0x0 - その他。0x0 - Other.

0x1 - ガベージ コレクション。0x1 - Garbage collection.

0x2 - アプリケーション ドメインのシャットダウン。0x2 - Application domain shutdown.

0x3 - コード ピッチ。0x3 - Code pitching.

0x4 - シャットダウン。0x4 - Shutdown.

0x5 - デバッガー。0x5 - Debugger.

0x6 - ガベージ コレクションの準備。0x6 - Preparation for garbage collection.
カウントCount win:UInt32win:UInt32 その時点の GC カウント。The GC count at the time. 通常、この後に後続の GC 開始イベントが表示され、そのカウントは、ガベージ コレクション中に、GC インデックスが増えるため、このカウント + 1 になります。Usually, you would see a subsequent GC Start event after this, and its Count would be this Count + 1 as we increase the GC index during a garbage collection.
ClrInstanceIDClrInstanceID win:UInt16win:UInt16 CLR または CoreCLR のインスタンスの一意の ID。Unique ID for the instance of CLR or CoreCLR.

ページのトップへBack to top

GCSuspendEEEnd_V1 イベントGCSuspendEEEnd_V1 Event

次の表に、キーワードとレベルを示します。The following table shows the keyword and level:

イベントを発生させるキーワードKeyword for raising the event レベルLevel
GCKeyword (0x1)GCKeyword (0x1) 情報提供 (4)Informational (4)

次の表に、イベント情報を示します。The following table shows the event information:

イベントEvent イベント IDEvent ID いつ発生するかRaised when
GCSuspendEEEnd_V1 88 ガベージ コレクションのための実行エンジンの中断の終了。End of suspension of the execution engine for garbage collection.

イベント データはありません。No event data.

ページのトップへBack to top

GCAllocationTick_V2 イベントGCAllocationTick_V2 Event

次の表に、キーワードとレベルを示します。The following table shows the keyword and level.

イベントを発生させるキーワードKeyword for raising the event レベルLevel
GCKeyword (0x1)GCKeyword (0x1) 情報提供 (4)Informational (4)

次の表に、イベント情報を示します。The following table shows the event information.

イベントEvent イベント IDEvent ID いつ発生するかRaised when
GCAllocationTick_V2 1010 約 100 KB が割り当てられるたび。Each time approximately 100 KB is allocated.

次の表に、イベント データを示します。The following table shows the event data.

フィールド名Field name データ型Data type 説明Description
AllocationAmountAllocationAmount win:UInt32win:UInt32 割り当てサイズ (バイト単位)。The allocation size, in bytes. この値は、ULONG (4,294,967,295 バイト) の長さより短い割り当ての場合に正確です。This value is accurate for allocations that are less than the length of a ULONG (4,294,967,295 bytes). 割り当てがこれを超える場合、このフィールドには切り捨てられた値が含まれます。If the allocation is greater, this field contains a truncated value. 非常に大きな割り当てには AllocationAmount64 を使用します。Use AllocationAmount64 for very large allocations.
AllocationKindAllocationKind win:UInt32win:UInt32 0x0 - 小さなオブジェクトの割り当て (小さなオブジェクト ヒープへの割り当て)。0x0 - Small object allocation (allocation is in small object heap).

0x1 - 大きなオブジェクトの割り当て (大きなオブジェクト ヒープへの割り当て)。0x1 - Large object allocation (allocation is in large object heap).
ClrInstanceIDClrInstanceID win:UInt16win:UInt16 CLR または CoreCLR のインスタンスの一意の ID。Unique ID for the instance of CLR or CoreCLR.
AllocationAmount64AllocationAmount64 win:UInt64win:UInt64 割り当てサイズ (バイト単位)。The allocation size, in bytes. この値は非常に大きな割り当ての場合に正確です。This value is accurate for very large allocations.
TypeIdTypeId win:Pointerwin:Pointer MethodTable のアドレス。The address of the MethodTable. このイベント中に複数の型のオブジェクトが割り当てられた場合、これは最後に割り当てられたオブジェクト (100 KB のしきい値を超えたオブジェクト) に対応する MethodTable のアドレスです。When there are several types of objects that were allocated during this event, this is the address of the MethodTable that corresponds to the last object allocated (the object that caused the 100 KB threshold to be exceeded).
TypeNameTypeName win:UnicodeStringwin:UnicodeString 割り当てられた型の名前。The name of the type that was allocated. このイベント中に複数の型のオブジェクトが割り当てられた場合は、これは最後に割り当てられたオブジェクト (100 KB のしきい値を超えたオブジェクト) の型です。When there are several types of objects that were allocated during this event, this is the type of the last object allocated (the object that caused the 100 KB threshold to be exceeded).
HeapIndexHeapIndex win:UInt32win:UInt32 オブジェクトが割り当てられたヒープ。The heap where the object was allocated. ワークステーションのガベージ コレクションと共に実行する場合、この値は 0 (ゼロ) になります。This value is 0 (zero) when running with workstation garbage collection.

ページのトップへBack to top

GCFinalizersBegin_V1 イベントGCFinalizersBegin_V1 Event

次の表に、キーワードとレベルを示します。The following table shows the keyword and level.

イベントを発生させるキーワードKeyword for raising the event レベルLevel
GCKeyword (0x1)GCKeyword (0x1) 情報提供 (4)Informational (4)

次の表に、イベント情報を示します。The following table shows the event information.

イベントEvent イベント IDEvent ID いつ発生するかRaised when
GCFinalizersBegin_V1 1414 ファイナライザーの実行の開始。The start of running finalizers.

イベント データはありません。No event data.

ページのトップへBack to top

GCFinalizersEnd_V1 イベントGCFinalizersEnd_V1 Event

次の表に、キーワードとレベルを示します。The following table shows the keyword and level.

イベントを発生させるキーワードKeyword for raising the event レベルLevel
GCKeyword (0x1)GCKeyword (0x1) 情報提供 (4)Informational (4)

次の表に、イベント情報を示します。The following table shows the event information.

イベントEvent イベント IDEvent ID いつ発生するかRaised when
GCFinalizersEnd_V1 1313 ファイナライザーの実行の終了。The end of running finalizers.

次の表に、イベント データを示します。The following table shows the event data.

フィールド名Field name データ型Data type 説明Description
カウントCount win:UInt32win:UInt32 実行されたファイナライザーの数。The number of finalizers that were run.
ClrInstanceIDClrInstanceID win:UInt16win:UInt16 CLR または CoreCLR のインスタンスの一意の ID。Unique ID for the instance of CLR or CoreCLR.

ページのトップへBack to top

GCCreateConcurrentThread_V1 イベントGCCreateConcurrentThread_V1 Event

次の表に、キーワードとレベルを示します。The following table shows the keyword and level.

イベントを発生させるキーワードKeyword for raising the event レベルLevel
GCKeyword (0x1)GCKeyword (0x1) 情報提供 (4)Informational (4)
ThreadingKeyword (0x10000)ThreadingKeyword (0x10000) 情報提供 (4)Informational (4)

次の表に、イベント情報を示します。The following table shows the event information.

イベントEvent イベント IDEvent ID いつ発生するかRaised when
GCCreateConcurrentThread_V1 1111 同時実行ガベージ コレクション スレッドが作成されました。Concurrent garbage collection thread was created.

イベント データはありません。No event data.

ページのトップへBack to top

GCTerminateConcurrentThread_V1 イベントGCTerminateConcurrentThread_V1 Event

次の表に、キーワードとレベルを示します。The following table shows the keyword and level.

イベントを発生させるキーワードKeyword for raising the event レベルLevel
GCKeyword (0x1)GCKeyword (0x1) 情報提供 (4)Informational (4)
ThreadingKeyword (0x10000)ThreadingKeyword (0x10000) 情報提供 (4)Informational (4)

次の表に、イベント情報を示します。The following table shows the event information.

イベントEvent イベント IDEvent ID いつ発生するかRaised when
GCTerminateConcurrentThread_V1 1212 同時実行ガベージ コレクションスレッドが終了しました。Concurrent garbage collection thread was terminated.

イベント データはありません。No event data.

関連項目See also