EventNameFilters
EventNameFilters 요소는 이름에 따라 추적 로깅 이벤트를 포함하거나 제외합니다.
참고
Windows 10 버전 1709 이상에서 사용할 수 있습니다.
요소 계층 구조
-
<
WindowsPerformanceRecorder>
-
<
Profiles>
-
<
EventProvider>
- < EventNameFilters>
-
<
Profile>
-
<
Collectors>
-
<
EventCollectorId>
-
<
EventProviders>
-
<
EventProvider>
- < EventNameFilters>
-
<
EventProvider>
-
<
EventProviders>
-
<
EventCollectorId>
-
<
Collectors>
-
<
EventProvider>
-
<
Profiles>
구문
<EventNameFilters FilterIn="true|false" Level="unsigned byte" Operation ="Set|Add|Remove" >
<!-- Child elements -->
<Keyword>
<EventName>
</EventNameFilters>
특성 및 요소
특성
attribute | Description | 데이터 형식 | 필수 | 기본값 |
---|---|---|---|---|
FilterIn | 지정된 stackwalk 이벤트의 포함 또는 제외 여부를 나타냅니다. | boolean | 예 | |
수준 | 이벤트 수준 | 부호 없는 바이트 | 예 | |
작업 | 키워드를 설정하거나 추가해야 하는지 여부를 나타냅니다. | 이 특성에는 다음 값 중 하나가 있을 수 있습니다.
|
예 | 설정 |
자식 요소
요소 | Description | 요구 사항 |
---|---|---|
EventName | 추적 로깅 이벤트 이름입니다. | 필수, 1 이상. |
키워드 | 이벤트 키워드 | 선택 사항 |
부모 요소
요소 | Description |
---|---|
EventProvider | 프로필에 대한 이벤트 공급자를 나타냅니다. |
설명
EventNameFilters 요소는 EVENT_FILTER_DESCRIPTOR, Type EVENT_FILTER_TYPE_EVENT_NAME을 통해 이벤트 필터링을 사용하도록 설정합니다.
ETW는 강력한 페이로드 및 특성 필터링을 지원하지만 이벤트는 주로 범위 필터를 기반으로 필터링하거나 CPU 오버헤드를 줄이기 위해 수준 및 키워드를 통해 필터링해야 합니다.
예제
<EventProvider Id="EventProvider_TraceLogGen" Name="3970F9cf-2c0c-4f11-b1cc-e3a1e9958833">
<EventNameFilters FilterIn="true" Level="5">
<Keyword Value="0x10000000000000"/>
<EventName Value="Preset1"/>
<EventName Value="Preset2"/>
</EventNameFilters>
</EventProvider>