StackKeywordLevelFilter
StackKeywordLevelFilter 요소는 stackwalk 이벤트를 포함하거나 제외할 이벤트 키워드 및 수준을 지정합니다.
참고
Windows 10 버전 1709 이상에서 사용할 수 있습니다.
요소 계층 구조
-
<
WindowsPerformanceRecorder>
-
<
Profiles>
-
<
EventProvider>
- < StackKeywordLevelFilter>
-
<
Profile>
-
<
Collectors>
-
<
EventCollectorId>
-
<
EventProviders>
-
<
EventProvider>
- < StackKeywordLevelFilter>
-
<
EventProvider>
-
<
EventProviders>
-
<
EventCollectorId>
-
<
Collectors>
-
<
EventProvider>
-
<
Profiles>
구문
<StackKeywordLevelFilter FilterIn = "true|false" Level = "unsigned byte" Operation = "Set|Add|Remove" >
<!-- Child elements -->
<keyword>
</StackKeywordLevelFilter>
특성 및 요소
특성
attribute | Description | 데이터 형식 | 필수 | 기본값 |
---|---|---|---|---|
FilterIn | 지정된 stackwalk 이벤트의 포함 또는 제외 여부를 나타냅니다. | boolean | 예 | |
수준 | 이벤트 수준 | 부호 없는 바이트 | 예 | |
작업 | 키워드를 설정하거나 추가해야 하는지 여부를 나타냅니다. | 이 특성에는 다음 값 중 하나가 있을 수 있습니다.
|
예 | 설정 |
자식 요소
요소 | Description | 요구 사항 |
---|---|---|
키워드 | 이벤트 키워드 | 필수 |
부모 요소
요소 | Description |
---|---|
EventProvider | 프로필에 대한 이벤트 공급자를 나타냅니다. |
설명
공급자에 대해 스택 워크를 사용하도록 설정하면 공급자가 생성한 모든 이벤트에 대해 스택이 캡처됩니다. 대부분의 경우 사용자는 특정 수의 이벤트에서만 스택에 관심이 있습니다. 이 요소를 사용하면 키워드 및 수준에 따라 스택 워크를 사용하거나 사용하지 않도록 설정할 수 있습니다.
ETW는 강력한 페이로드 및 특성 필터링을 지원하지만 이벤트는 주로 범위 필터를 기반으로 필터링하거나 CPU 오버헤드를 줄이기 위해 수준 및 키워드를 통해 필터링해야 합니다.
예제
<EventProvider Id="EventProvider_TraceLogGen" Name="*TraceLogGen">
<StackKeywordLevelFilter FilterIn="true" Level="5">
<Keyword Value="0x10000000000000"/>
</StackKeywordLevelFilter>
</EventProvider>