1. 수집기 정의
WPR(Windows Performance Recorder)은 현재 세 가지의 수집기인 시스템 수집기, 이벤트 수집기, 힙 이벤트 수집기를 지원합니다. 시스템 수집기 정의는 NT 커널 로거와 함께 작동하는 ETW(Windows용 이벤트 추적) 시스템 로거 세션에 대한 버퍼 크기 및 기타 특성을 지정합니다. 이벤트 및 힙 수집기 정의는 ETW 사용자 세션에 대한 버퍼 크기 및 기타 특성을 지정합니다.
수집기 정의 순서는 WPR 스키마에 의해 제한됩니다. .wprp 파일에서 시스템 수집기 정의는 이벤트 수집기 정의보다 앞에 와야 합니다. 이러한 정의는 모두 힙 수집기 정의보다 앞에 와야 합니다(힙 수집기 정의가 있는 경우). WPR 스키마는 WPRControlProfiles 스키마에 정의되어 있습니다.
수집기 특성
수집기에는 다음과 같은 필수 특성이 있습니다.
ID: .wprp 파일의 수집기 정의를 참조하는 고유 문자열 식별자.
이름: 수집기의 이름(예: “WPR Collector”). 시스템 수집기 이름은 “NT 커널 로거”여야 합니다.
수집기 정의에는 다음 버퍼 크기 정의가 포함되어야 합니다.
BufferSize: 단일 버퍼의 크기(KB)를 지정합니다.
버퍼: 버퍼 수를 지정하거나 PercentageOfTotalMemory 특성이 “true”로 설정된 경우 버퍼링에 사용할 총 메모리의 백분율을 지정합니다.
버퍼에 대한 자세한 내용은 로깅 모드를 참조하세요.
수집기 정의 예제
다음 코드 예제는 시스템 수집기 정의 및 이벤트 수집기 정의를 보여 줍니다.
<SystemCollector
Id="WPRSystemCollector"
Name="NT Kernel Logger"
FileName="WPRKernel.etl">
<BufferSize
Value="512"/>
<Buffers
Value="3"
PercentageOfTotalMemory="true"/>
</SystemCollector>
<EventCollector
Id="WPREventCollector"
Name="WPR Event Collector"
FileName="somefilename.etl">
<BufferSize
Value="128"/>
<Buffers
Value="64"/>
</EventCollector>
<HeapEventCollector
Id="Base_Heap_Collector"
Name="Base Heap Collector"
FileName="heap.etl">
</HeapEventCollector>
상속 예제
Windows Performance Recorder는 WPR 프로필 XML 스키마에서 Base="" 특성을 사용하여 해당 개체의 상속을 지원합니다. 이렇게 하면 일반적인 정의를 다시 사용하는 동시에 개체의 추가 또는 특수화를 점진적으로 빌드할 수 있습니다.
특정 시나리오에서는 의도하지 않은 복잡성과 부작용이 발생할 수 있습니다. 이 섹션에서는 예제와 권장 모범 사례에 대해 설명합니다.
예제 1
프로필 프로필 A에서 이벤트 수집기 수집기 A를 일부 수정하여 사용하려는 경우 수집기 A에서 파생된 수집기 수집기 A2를 정의할 수 있습니다. (Base="Collector A")를 클릭한 다음 해당 수집기 수집기 A2를 참조합니다. 이는 수집기 개체만 다른 수집기 개체에서 파생되고 직접 참조되므로 권장됩니다.
예 2
프로필 프로필 A는 수집기 수집기 A를 참조합니다. 다른 프로필 프로필 B는 프로필 A에서 파생되도록 변경해야 하며 해당 정의에서 직접 변경 사항을 지정합니다. 이는 프로필 개체만 다른 프로필 개체에서 파생되므로 권장됩니다.
예제 3
프로필 프로필 A는 수집기 수집기 A를 참조합니다. 수집가 수집기 A2는 수집기 A에서 파생됩니다. 마지막으로 프로필 프로필 B는 프로필 A에서 파생되며 프로필 B의 부모 프로필에서 이미 참조된 수집기 A도 참조합니다.
이 경우 수집기 A2에 대한 정의를 평가하는 방법이 모호합니다. 어떤 경우 프로필 파생이 우선하고 다른 경우에는 수집기 파생이 우선합니다. 이 방법은 순서가 정의되지 않고 작업 순서에 따라 다른 결과를 초래할 수 있으므로 권장되지 않습니다.
이를 기반으로 여러 형식의 개체에서 파생을 결합해서는 안 됩니다.