マーカーとしての EventSource イベントの視覚化

同時実行ビジュアライザーはマーカーとして EventSource のイベントを表示するマーカーの表示方法を制御できます。EventSource マーカーを表示するには、 詳細設定 のダイアログ ボックスを使用して ETW プロバイダーの GUID を登録します。同時実行ビジュアライザーは フラグ マーカー、 スパン マーカーと メッセージ マーカーとして EventSource のイベントを表す既定の規則があります。EventSource のイベントがイベントにカスタム フィールドを追加することによって表示方法をカスタマイズできます。マーカーに関する詳細については、 同時実行ビジュアライザー マーカーを参照してください。EventSource のイベントに関する詳細については、 System.Diagnostics.Tracingを参照してください。

EventSource のイベントのビジュアル化を設定します。

既定では、同時実行ビジュアライザーは EventSource のイベントを表すには、次の規則を使用します。

マーカーの種類

1. オペコード の優先のイベント: 開始または優先: 扱われます範囲の開始または終了として、それぞれ停止します。入れ子または範囲と重複することは表示できません。別の 1 種類のスレッドと末尾で始まるイベントのペアを表示できません。

2. オペコードが、どちらも優先ではないイベント: 開始優先: レベル （EVENT_RECORD.EVENT_HEADER.EVENT_DESCRIPTOR のフィールド）が優先でない場合は処理マーカーのフラグとして停止する: 詳細またはそれ以上。

3. それ以外の場合は、イベントはメッセージとして扱われます。

重要度

次の表にマーカーの重要性にイベント レベル マップ定義されています。

ファミリ名

イベントのタスク名は、ファミリ名に使用されます。ファミリ名は、タスクがイベントに対して定義されていない場合は空です。

[カテゴリ]

レベルが優先場合: クリティカルまたは優先: エラーは、カテゴリ通知です （- 1）。は、カテゴリは既定の （0）です。

テキスト

printf 型の書式設定されたテキストのメッセージがイベントに対して定義されている場合、マーカーの説明として表示されます。それ以外の場合は、ついては、各フィールドのペイロード イベントと値の名前です。

EventSource のイベントのビジュアル化のカスタマイズ

以降のセクションで説明するように EventSource のイベントがイベントに適切なフィールドを追加することによって表示方法をカスタマイズできます。

マーカーの種類

イベントを表すために使用されるマーカーの種類を制御するために cvType フィールド、バイトを使用します。cvType の使用可能な値は、です:

重要度

EventSource のイベントに対して設定する重要度を制御するために cvImportance フィールド、を使用できます。ただし、レベルを使用してイベントの表示、重要度を制御することをお勧めします。

ファミリ名

同時実行ビジュアライザーが EventSource のイベントに対するファミリ名を制御するために cvSeries のイベント フィールド、文字列を使用します。

[カテゴリ]

同時実行ビジュアライザーが EventSource のイベントに対するカテゴリを制御するために cvCategory フィールド、バイトを使用します。

テキスト

同時実行ビジュアライザーが EventSource のイベントに関する説明を制御するために cvTextW フィールド、文字列を使用します。

SpanID

イベントのペアに cvSpanId フィールド、 int を使用します。範囲を表す開始/停止イベントの各ペアの値は一意である必要があります。通常、同時実行コードの場合、これは Exchange などの同期プリミティブの使用を CvSpanID に使用されるキー （値）が正しいことを確認する必要があります。

[!メモ]

SpanID の使用は範囲にある、部分的に同じスレッドで重複するようにするには、 1 種類のスレッドで開始されるようにし、別の終了することはできません。

参照

概念

同時実行ビジュアライザー マーカー