次の方法で共有


スレッド プール ETW イベント

これらのイベントは、ワーカーと I/O スレッドに関する情報を収集します。

スレッド プール イベントには次の 2 つのグループがあります。

  • ワーカー スレッド プール イベント。アプリケーションによるスレッド プールの使用方法および同時実行制御に対する作業負荷の影響に関する情報を提供します。

  • I/O スレッド プール イベント。スレッド プール内で作成、リタイア、リタイア解除、または終了が行われた I/O スレッドに関する情報を提供します。

ワーカー スレッド プール イベント

これらのイベントは、ランタイムのワーカー スレッド プールに関連するイベントで、スレッド イベント (スレッドが作成されたときや停止したときなど) の通知を提供します。 ワーカー スレッド プールでは、同時実行制御にアダプティブ アルゴリズムが使用されているため、測定されたスループットに基づいてスレッドの数が計算されます。 ワーカー スレッド プール イベントを使用すると、アプリケーションでスレッド プールがどのように使用されているかや、特定の作業負荷が同時実行制御にどのような影響を与えるのかを把握できます。

ThreadPoolWorkerThreadStart および ThreadPoolWorkerThreadStop

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

イベントを発生させるキーワード

レベル

ThreadingKeyword (0x10000)

情報提供 (4)

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

イベント

イベント ID

いつ発生するか

ThreadPoolWorkerThreadStart

50

ワーカー スレッドが作成されました。

ThreadPoolWorkerThreadStop

51

ワーカー スレッドが停止しました。

ThreadPoolWorkerThreadRetirementStart

52

ワーカー スレッドがリタイアしました。

ThreadPoolWorkerThreadRetirementStop

53

リタイアしたワーカー スレッドが再びアクティブになりました。

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

フィールド名

データ型

説明

ActiveWorkerThreadCount

win:UInt32

作業の処理に使用できるワーカー スレッドの数 (既に作業を処理しているスレッドを含む)。

RetiredWorkerThreadCount

win:UInt32

作業の処理には使用できないが、より多くのスレッドが必要になった場合のために保持されているワーカー スレッドの数。

ClrInstanceID

Win:UInt16

CLR または CoreCLR のインスタンスの一意の ID。

ThreadPoolWorkerThreadAdjustment

これらのスレッド プール イベントは、スレッド インジェクション (同時実行制御) アルゴリズムの動作の把握およびデバッグのための情報を提供します。 この情報は、ワーカー スレッド プールによって内部で使用されます。

ThreadPoolWorkerThreadAdjustmentSample

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

イベントを発生させるキーワード

レベル

ThreadingKeyword (0x10000)

情報提供 (4)

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

イベント

イベント ID

説明

ThreadPoolWorkerThreadAdjustmentSample

54

1 つのサンプルについての一連の情報 (ある時点における特定の同時実行レベルでのスループットの測定値) を表します。

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

フィールド名

データ型

説明

Throughput

win:Double

単位時間あたりの完了数。

ClrInstanceID

Win:UInt16

CLR または CoreCLR のインスタンスの一意の ID。

ThreadPoolWorkerThreadAdjustmentAdjustment

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

イベントを発生させるキーワード

レベル

ThreadingKeyword (0x10000)

情報提供 (4)

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

イベント

イベント ID

説明

ThreadPoolWorkerThreadAdjustmentAdjustment

55

スレッド インジェクション (山登り法) アルゴリズムによって同時実行レベルの変更が確認された場合に制御の変更を記録します。

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

フィールド名

データ型

説明

AverageThroughput

win:Double

測定値のサンプルの平均スループット。

NewWorkerThreadCount

win:UInt32

アクティブなワーカー スレッドの新しい数。

理由

win:UInt32

調整の理由。

0x00 - ウォームアップ。

0x01 - 初期化。

0x02 - ランダムな動き。

0x03 - 上昇の動き。

0x04 - 変化点。

0x05 - 安定化。

0x06 - 不足。

0x07 - スレッドのタイムアウト。

ClrInstanceID

Win:UInt16

CLR または CoreCLR のインスタンスの一意の ID。

ThreadPoolWorkerThreadAdjustmentStats

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

イベントを発生させるキーワード

レベル

ThreadingKeyword (0x10000)

情報提供 (4)

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

イベント

イベント ID

説明

ThreadPoolWorkerThreadAdjustmentStats

56

スレッド プールについてのデータを収集します。

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

フィールド名

データ型

説明

Duration

win:Double

これらの統計情報が収集された期間 (秒)。

Throughput

win:Double

この期間の 1 秒あたりの平均完了数。

ThreadWave

win:Double

内部使用のために予約されています。

ThroughputWave

win:Double

内部使用のために予約されています。

ThroughputErrorEstimate

win:Double

内部使用のために予約されています。

AverageThroughputErrorEstimate

win:Double

内部使用のために予約されています。

ThroughputRatio

win:Double

この期間のアクティブなワーカー スレッド数の変化によってスループットがどれくらい改善されたかを相対的に示す値。

Confidence

win:Double

ThroughputRatio フィールドの妥当性の尺度。

NewcontrolSetting

win:Double

アクティブなスレッド数の将来の変化のベースラインとして使用されるアクティブなワーカー スレッドの数。

NewThreadWaveMagnitude

Win:UInt16

アクティブなスレッド数の将来の変化の大きさ。

ClrInstanceID

Win:UInt16

CLR または CoreCLR のインスタンスの一意の ID。

ページのトップへ

I/O スレッド イベント

これらのスレッド プール イベントは、非同期の I/O スレッド プール (完了ポート) のスレッドに対して発生します。

IOThreadCreate_V1

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

イベントを発生させるキーワード

レベル

ThreadingKeyword (0x10000)

情報提供 (4)

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

イベント

イベント ID

いつ発生するか

IOThreadCreate_V1

44

スレッド プールで I/O スレッドが作成されたとき。

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

フィールド名

データ型

説明

[カウント]

win:UInt64

I/O スレッドの数 (新たに作成されたスレッドを含む)。

NumRetired

win:UInt64

リタイアしたワーカー スレッドの数。

ClrInstanceID

Win:UInt16

CLR または CoreCLR のインスタンスの一意の ID。

IOThreadRetire_V1

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

イベントを発生させるキーワード

レベル

ThreadingKeyword (0x10000)

情報提供 (4)

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

イベント

イベント ID

いつ発生するか

IOThreadRetire_V1

46

I/O スレッドがリタイアの候補になったとき。

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

フィールド名

データ型

説明

[カウント]

win:UInt64

スレッド プールに残っている I/O スレッドの数。

NumRetired

win:UInt64

リタイアした I/O スレッドの数。

ClrInstanceID

Win:UInt16

CLR または CoreCLR のインスタンスの一意の ID。

IOThreadUnretire_V1

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

イベントを発生させるキーワード

レベル

ThreadingKeyword (0x10000)

情報提供 (4)

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

イベント

イベント ID

いつ発生するか

IOThreadUnretire_V1

47

I/O スレッドがリタイア候補になった後の待機期間の間に I/O が受信されたためにスレッドがリタイア解除されたとき。

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

フィールド名

データ型

説明

[カウント]

win:UInt64

スレッド プール内の I/O スレッドの数 (このスレッドを含む)。

NumRetired

win:UInt64

リタイアした I/O スレッドの数。

ClrInstanceID

Win:UInt16

CLR または CoreCLR のインスタンスの一意の ID。

IOThreadTerminate

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

イベントを発生させるキーワード

レベル

ThreadingKeyword (0x10000)

情報提供 (4)

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

イベント

イベント ID

いつ発生するか

IOThreadTerminate

45

スレッド プールで I/O スレッドが作成されたとき。

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

フィールド名

データ型

説明

[カウント]

win:UInt64

スレッド プールに残っている I/O スレッドの数。

NumRetired

win:UInt64

リタイアした I/O スレッドの数。

ClrInstanceID

Win:UInt16

CLR または CoreCLR のインスタンスの一意の ID。

ページのトップへ

参照

概念

CLR ETW イベント