MaximumFileSize

아티클
07/17/2024

추적 파일의 최대 파일 크기(.etl)를 설정합니다. FileMode 특성이 Sequential인 경우 파일 크기가 지정된 크기에 도달하면 추적이 중지됩니다. FileMode 특성이 Circular인 경우 파일은 최신 이벤트를 유지합니다.

요소 계층 구조

< WindowsPerformanceRecorder>
- < Profiles>
  - < SystemCollector>
    - < MaximumFileSize>
  - < EventCollector>
    - < MaximumFileSize>
  - < HeapEventCollector>
    - < MaximumFileSize>
  - < HypervisorEventCollector>
    - < MaximumFileSize>
  - < Profile>
    - < Collectors>
      - < SystemCollectorId>
        
        < MaximumFileSize>
      - < EventCollectorId>
        
        < MaximumFileSize>
      - < HeapEventCollectorId>
        
        < MaximumFileSize>
      - < HypervisorEventCollectorId>
        
        < MaximumFileSize>

구문

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

특성 및 요소

특성

attribute	Description	데이터 형식	필수	기본값
작업	MaximumFileSize를 설정해야 할지 또는 추가해야 할지를 나타냅니다.	이 특성 값은 다음 중 하나일 수 있습니다. 설정 추가 제거	예	설정
값	MaximumFileSize를 MB 단위로 나타냅니다.	unsignedLong	Yes
FileMode	`Sequential`로 설정된 경우 추적은 지정된 크기에 도달하면 중지됩니다.	String	No	순환

자식 요소

없음

부모 요소

요소	Description
EventCollector	이벤트 수집기를 나타냅니다.
EventCollectorId	이벤트 수집기 식별자를 나타냅니다.
HeapEventCollector	힙 이벤트 수집기를 나타냅니다.
HeapEventCollectorId	힙 이벤트 수집기 식별자를 나타냅니다.
SystemCollector	시스템 수집기를 나타냅니다.
SystemCollectorId	시스템 수집기 식별자를 나타냅니다.
HypervisorCollector	하이퍼바이저 수집기를 나타냅니다.
HypervisorCollectorId	하이퍼바이저 수집기 식별자를 나타냅니다.

설명

이 요소는 파일 모드 캡처에만 사용됩니다.

예제

다음 예제에서는 이벤트 수집기 정의에서 이 요소를 사용하는 방법을 보여 줍니다.

이 예제는 각각 128KB의 버퍼 40개를 설정하고 최대 파일 크기를 100MB로 설정합니다. 최신 이벤트 데이터를 유지하여 파일 크기가 100MB에 도달하면 추적 세션이 중지되지 않습니다.

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

HypervisorEventCollector