例 8: トレース バッファの設定

次のコマンドは、トレース ログ セッションを開始し、セッションのバッファーをカスタマイズします。

tracelog -start MyTrace -guid MyProvider.guid -f testtrace.etl -flag 2 -level ffff -b 128 -min 10 -max 30

そのコマンドは、"MyTrace" という名前のセッションを開始します。 -guid パラメーターを使用してプロバイダー ファイルを指定し、 -f パラメーターを使用してトレース ログの名前と場所を指定します。

-flag パラメーターを使用してフラグ値を 2 に設定し、レベル値を FFFF に設定する -level パラメーターを使用して、使用可能なすべてのトレース メッセージを生成します。 これらの設定はプロバイダーに固有です。

高いメッセージ レートに対応するために、このコマンドでは 、 -b パラメーターを使用して各バッファーのサイズを 128 KB (キロバイト)に増やし、バッファーの最小数を 10 に増やす -min パラメーター、バッファーの最大数を 30 に増やす -max パラメーターを使用します。

これに対して、Tracelog はトレース セッションを開始し、いくつかのセッション プロパティを表示します。 コマンドによって設定されたプロパティは、識別しやすくするために太字で表示されます。

Logger Started...
Enabling trace to logger 2
Operation Status:       0L      The operation completed successfully.

Logger Name:            MyTrace
Logger Id:              2
Logger Thread Id:       00000D7C
Buffer Size:            128 Kb
Maximum Buffers:        30
Minimum Buffers:        10
Number of Buffers:      10
Free Buffers:           9
Buffers Written:        1
Events Lost:            0
Log Buffers Lost:       0
Real Time Buffers Lost: 0
AgeLimit:               15
Log File Mode:          Sequential
Enabled tracing:        0x00000002
Log Filename:           d:\traces\testtrace.etl 

トレース セッション プロパティ リストの Events Lost カウンターを監視することが常に重要です。 イベントを失う場合は、バッファー容量 (サイズ、数、またはその両方) を増やしてトレース セッションを再実行します。 トレース セッションのプロパティを表示するには、 tracelog -l または tracelog -qSessionName を使用します。