MaximumFileSize

[アーティクル]
07/17/2024

トレースファイル (.etl) の最大ファイルサイズを設定します。属性がトレースの FileMode 場合は Sequential 、ファイルサイズが指定したサイズに達すると停止します。属性がの FileMode 場合、 Circularファイルは最新のイベントを保持します。

要素の階層

< WindowsPerformanceRecorder>
- < プロファイル>
  - < SystemCollector>
    - < MaximumFileSize>
  - < EventCollector>
    - < MaximumFileSize>
  - < HeapEventCollector>
    - < MaximumFileSize>
  - < HypervisorEventCollector>
    - < MaximumFileSize>
  - < Profile>
    - < コレクター>
      - < SystemCollectorId>
        
        < MaximumFileSize>
      - < EventCollectorId>
        
        < MaximumFileSize>
      - < HeapEventCollectorId>
        
        < MaximumFileSize>
      - < HypervisorEventCollectorId>
        
        < MaximumFileSize>

構文

<MaximumFileSize Operation               = "Set" | "Add" | “Remove”
         Value                   = unsignedLong
         FileMode = "Circular" | "Sequential">
</MaximumFileSize>

属性および要素

属性

属性	説明	データ型	必須	Default
操作	MaximumFileSize を設定するか追加するかを示します。	この属性は、次のいずれかの値になります。オン追加削除	いいえ	オン
Value	MaximumFileSize の数を MB 単位で示します。	unsignedLong	はい
FileMode	トレースに `Sequential` 設定すると、指定したサイズに達すると停止します。	String	いいえ	円形

子要素

なし。

親要素

要素	説明
EventCollector	イベントコレクターを表します。
EventCollectorId	イベントコレクター識別子を表します。
HeapEventCollector	ヒープイベントコレクターを表します。
HeapEventCollectorId	ヒープイベントコレクター識別子を表します。
SystemCollector	システムコレクターを表します。
SystemCollectorId	システムコレクター識別子を表します。
HypervisorCollector	ハイパーバイザーコレクターを表します。
HypervisorCollectorId	ハイパーバイザーコレクター識別子を表します。

解説

この要素は、ファイルモードのキャプチャにのみ使用されます。

例

次の例は、イベントコレクター定義でこの要素がどのように使用されるかを示しています。

この例では、それぞれ 128 KB のバッファーを 40 個、最大ファイルサイズを 100 MB に設定します。最新のイベントデータを保持することで、ファイルサイズが 100 MB に達してもトレースセッションは停止しません。

<EventCollector Id="EventCollector_MultimediaEx" Name="WPDiet MultimediaEx">
  <BufferSize Value="128"/>
  <Buffers Value="40"/>
  <MaximumFileSize Value="100" FileMode="Circular"/>
</EventCollector>

HypervisorEventCollector