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

更新 : 2010 年 8 月

これらのイベントは、ガベージ コレクションに関連する情報を収集します。 ガベージ コレクションが実行された回数、ガベージ コレクションの間に解放されたメモリの量など、診断やデバッグに役立つ情報を入手できます。

このカテゴリは、次のイベントで構成されます。

• GCStart_V1 イベント

• GCEnd_V1 イベント

• GCHeapStats_V1 イベント

• GCCreateSegment_V1 イベント

• GCFreeSegment_V1 イベント

• GCRestartEEBegin_V1 イベント

• GCRestartEEEnd_V1 イベント

• GCSuspendEE_V1 イベント

• GCSuspendEEEnd_V1 イベント

• GCAllocationTick_V1 イベント

• GCFinalizersBegin_V1 イベント

• GCFinalizersEnd_V1 イベント

• GCCreateConcurrentThread_V1 イベント

• GCTerminateConcurrentThread_V1 イベント

GCStart_V1 イベント

次の表に、キーワードとレベルを示します (詳細については、「CLR ETW キーワードおよびレベル」を参照してください)。

イベントを発生させるキーワード	レベル
GCKeyword (0x1)	情報提供 (4)

次の表に、イベント情報を示します。

イベント	イベント ID	いつ発生するか
GCStart_V1	1	ガベージ コレクションが開始されました。

次の表に、イベント データを示します。

フィールド名	データ型	説明
[カウント]	win:UInt32	n 回目のガベージ コレクション。
Depth	win:UInt32	収集されるジェネレーション。
理由	win:UInt32	ガベージ コレクションが発生した理由: 0x0 - 小さなオブジェクト ヒープの割り当て。 0x1 - 強制実行。 0x2 - メモリ不足。 0x3 - 空。 0x4 - 大きなオブジェクト ヒープの割り当て。 0x5 - 領域不足 (小さなオブジェクト ヒープ対象)。 0x6 - 領域不足 (大きなオブジェクト ヒープ対象)。
型	win:UInt32	0x0 - バックグラウンド ガベージ コレクションの外部で発生するブロッキング ガベージ コレクション。 0x1 - バックグラウンド ガベージ コレクション。 0x2 - バックグラウンド ガベージ コレクションの実行中に発生するブロッキング ガベージ コレクション。
ClrInstanceID	win:UInt16	CLR または CoreCLR のインスタンスの一意の ID。

ページのトップへ

GCEnd_V1 イベント

次の表に、キーワードとレベルを示します。

イベントを発生させるキーワード	レベル
GCKeyword (0x1)	情報提供 (4)

次の表に、イベント情報を示します。

イベント	イベント ID	いつ発生するか
GCEnd_V1	2	ガベージ コレクションが終了しました。

次の表に、イベント データを示します。

フィールド名	データ型	説明
[カウント]	win:UInt32	n 回目のガベージ コレクション。
Depth	win:UInt32	収集されたジェネレーション。
ClrInstanceID	win:UInt16	CLR または CoreCLR のインスタンスの一意の ID。

ページのトップへ

GCHeapStats_V1 イベント

次の表に、キーワードとレベルを示します。

イベントを発生させるキーワード	レベル
GCKeyword (0x1)	情報提供 (4)

次の表に、イベント情報を示します。

イベント	イベント ID	説明
GCHeapStats_V1	4	各ガベージ コレクション終了時のヒープの統計情報を示します。

次の表に、イベント データを示します。

フィールド名	データ型	説明
GenerationSize0	win:UInt64	ジェネレーション 0 メモリのサイズ (バイト単位)。
TotalPromotedSize0	win:UInt64	ジェネレーション 0 からジェネレーション 1 に移されたバイト数。
GenerationSize1	win:UInt64	ジェネレーション 1 メモリのサイズ (バイト単位)。
TotalPromotedSize1	win:UInt64	ジェネレーション 1 からジェネレーション 2 に移されたバイト数。
GenerationSize2	win:UInt64	ジェネレーション 2 メモリのサイズ (バイト単位)。
TotalPromotedSize2	win:UInt64	最後のガベージ コレクションの後にジェネレーション 2 に残ったバイト数。
GenerationSize3	win:UInt64	大きなオブジェクト ヒープのサイズ (バイト単位)。
TotalPromotedSize3	win:UInt64	最後のガベージ コレクションの後に大きなオブジェクト ヒープに残ったバイト数。
FinalizationPromotedSize	win:UInt64	終了準備が完了しているオブジェクトの合計サイズ (バイト単位)。
FinalizationPromotedCount	win:UInt64	終了準備が完了しているオブジェクトの数。
PinnedObjectCount	win:UInt32	ピン止めオブジェクト (移動できないオブジェクト) の数。
SinkBlockCount	win:UInt32	使用中の同期ブロックの数。
GCHandleCount	win:UInt32	使用中のガベージ コレクション ハンドルの数。
ClrInstanceID	win:UInt16	CLR または CoreCLR のインスタンスの一意の ID。

ページのトップへ

GCCreateSegment_V1 イベント

次の表に、キーワードとレベルを示します。

イベントを発生させるキーワード	レベル
GCKeyword (0x1)	情報提供 (4)

次の表に、イベント情報を示します。

イベント	イベント ID	いつ発生するか
GCCreateSegment_V1	5	新しいガベージ コレクション セグメントが作成されました。 既に実行されているプロセスでトレースを有効にした場合は、このイベントが各既存セグメントについて発生します。

次の表に、イベント データを示します。

フィールド名	データ型	説明
Address	win:UInt64	セグメントのアドレス。
サイズ	win:UInt64	セグメントのサイズ。
Type	win:UInt32	0x0 - 小さなオブジェクト ヒープ。 0x1 - 大きなオブジェクト ヒープ。 0x2 - 読み取り専用ヒープ。
ClrInstanceID	win:UInt16	CLR または CoreCLR のインスタンスの一意の ID。

ページのトップへ

GCFreeSegment_V1 イベント

次の表に、キーワードとレベルを示します。

イベントを発生させるキーワード	レベル
GCKeyword (0x1)	情報提供 (4)

次の表に、イベント情報を示します。

イベント	イベント ID	いつ発生するか
GCFreeSegment_V1	6	ガベージ コレクション セグメントが解放されました。

次の表に、イベント データを示します。

フィールド名	データ型	説明
Address	win:UInt64	セグメントのアドレス。
ClrInstanceID	win:UInt16	CLR または CoreCLR のインスタンスの一意の ID。

ページのトップへ

GCRestartEEBegin_V1 イベント

次の表に、キーワードとレベルを示します。

イベントを発生させるキーワード	レベル
GCKeyword (0x1)	情報提供 (4)

次の表に、イベント情報を示します。

イベント	イベント ID	いつ発生するか
GCRestartEEBegin_V1	7	共通言語ランタイムの中断からの再開が開始されました。

イベント データはありません。

ページのトップへ

GCRestartEEEnd_V1 イベント

次の表に、キーワードとレベルを示します。

イベントを発生させるキーワード	レベル
GCKeyword (0x1)	情報提供 (4)

次の表に、イベント情報を示します。

イベント	イベント ID	いつ発生するか
GCRestartEEEnd_V1	3	共通言語ランタイムの中断からの再開が終了しました。

イベント データはありません。

ページのトップへ

GCSuspendEE_V1 イベント

次の表に、キーワードとレベルを示します。

イベントを発生させるキーワード	レベル
GCKeyword (0x1)	情報提供 (4)

次の表に、イベント情報を示します。

イベント	イベント ID	いつ発生するか
GCSuspendEE_V1	9	ガベージ コレクションのための実行エンジンの中断の開始。

次の表に、イベント データを示します。

フィールド名	データ型	説明
理由	win:UInt16	0x0 - その他。 0x1 - ガベージ コレクション。 0x2 - アプリケーション ドメインのシャットダウン。 0x3 - コード ピッチ。 0x4 - シャットダウン。 0x5 - デバッガー。 0x6 - ガベージ コレクションの準備。
[カウント]	win:UInt32	中断されるスレッドの数。
ClrInstanceID	win:UInt16	CLR または CoreCLR のインスタンスの一意の ID。

ページのトップへ

GCSuspendEEEnd_V1 イベント

次の表に、キーワードとレベルを示します。

イベントを発生させるキーワード	レベル
GCKeyword (0x1)	情報提供 (4)

次の表に、イベント情報を示します。

イベント	イベント ID	いつ発生するか
GCSuspendEEEnd_V1	8	ガベージ コレクションのための実行エンジンの中断の終了。

イベント データはありません。

ページのトップへ

GCAllocationTick_V1 イベント

次の表に、キーワードとレベルを示します。

イベントを発生させるキーワード	レベル
GCKeyword (0x1)	情報提供 (4)

次の表に、イベント情報を示します。

イベント	イベント ID	いつ発生するか
GCAllocationTick_V1	10	約 100 KB が割り当てられるたび。

次の表に、イベント データを示します。

フィールド名	データ型	説明
AllocationSize	win:UInt32	割り当てサイズ。
Kind	win:UInt32	0x0 - 小さなオブジェクトの割り当て (小さなオブジェクト ヒープへの割り当て)。 0x1 - 大きなオブジェクトの割り当て (大きなオブジェクト ヒープへの割り当て)。
ClrInstanceID	win:UInt16	CLR または CoreCLR のインスタンスの一意の ID。

ページのトップへ

GCFinalizersBegin_V1 イベント

次の表に、キーワードとレベルを示します。

イベントを発生させるキーワード	レベル
GCKeyword (0x1)	情報提供 (4)

次の表に、イベント情報を示します。

イベント	イベント ID	いつ発生するか
GCFinalizersBegin_V1	14	ファイナライザーの実行の開始。

イベント データはありません。

ページのトップへ

GCFinalizersEnd_V1 イベント

次の表に、キーワードとレベルを示します。

イベントを発生させるキーワード	レベル
GCKeyword (0x1)	情報提供 (4)

次の表に、イベント情報を示します。

イベント	イベント ID	いつ発生するか
GCFinalizersEnd_V1	13	ファイナライザーの実行の終了。

次の表に、イベント データを示します。

フィールド名	データ型	説明
[カウント]	win:UInt32	実行されたファイナライザーの数。
ClrInstanceID	win:UInt16	CLR または CoreCLR のインスタンスの一意の ID。

ページのトップへ

GCCreateConcurrentThread_V1 イベント

次の表に、キーワードとレベルを示します。

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

次の表に、イベント情報を示します。

イベント	イベント ID	いつ発生するか
GCCreateConcurrentThread_V1	11	同時実行ガベージ コレクション スレッドが作成されました。

イベント データはありません。

ページのトップへ

GCTerminateConcurrentThread_V1 イベント

次の表に、キーワードとレベルを示します。

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

次の表に、イベント情報を示します。

イベント	イベント ID	いつ発生するか
GCTerminateConcurrentThread_V1	12	同時実行ガベージ コレクションスレッドが終了しました。

イベント データはありません。

ページのトップへ

参照

概念

CLR ETW イベント

履歴の変更

日付	履歴	理由
2010 年 8 月	GCStart_V1 イベントの型情報を修正。	コンテンツ バグ修正