EventProvider

ETW(Windows용 이벤트 추적) 사용자 모드 공급자를 구성합니다.

요소 계층 구조

• < WindowsPerformanceRecorder>
  • < Profiles>
    • < EventProvider>
    • < Profile>
      • < Collectors>
        • < EventCollectorId>
          • < EventProviders>
            • < EventProvider>

구문

<EventProvider Id               = IdType
               Name             = string
               Base             = string
               NonPageMemory    = boolean
               Stack            = boolean
               SID              = boolean
               TSID             = boolean
               Level            = unsigendByte
               CaptureStateOnly = boolean
               Strict           = boolean
               ProcessExeFilter = string
               EventKey         = boolean
               ExcludeInPrivate = boolean>

  <!-- Child elements -->
  Keywords,
  CaptureStateOnStart,
  CaptureStateOnSave,
  CaptureStateOnDemand,
  Stacks,
  EventFilters,
  StackFilters,
  EventNameFilters,
  StackEventNameFilters,
  StackKeywordLevelFilter
</EventProvider>

특성 및 요소

특성

자식 요소

부모 요소

설명

공급자 정의 순서가 중요합니다. 정의는 .wprp 파일에서 다음 순서로 표시되어야 합니다.

1. 수집기
2. 시스템 공급자
3. 이벤트 공급자

선택적 내부 XML 태그는 사용하도록 설정할 키워드를 지정합니다. 시스템 공급자와 달리 이벤트 공급자에 대해 정의된 텍스트 상수가 없으므로 16진수 스타일 문자열을 사용해야 합니다. 그러나 구문은 시스템 공급자와 동일합니다. 키워드를 지정하지 않으면 기본값인 0이 사용됩니다(ETW에서 문자열 0xFFFFFFFFFFFFFFFF로 처리됨).

파생 이벤트 공급자에는 기본적으로 기본 공급자의 모든 특성이 있습니다. 파생 공급자에서 명시적으로 지정하여 재정의할 수 있습니다. 자세한 내용은 상속을 참조하세요.

예제

다음 예제에서는 두 이벤트 공급자를 정의합니다.

<EventProvider
  Id="Win32K-provider"
  Name="Microsoft-Windows-Win32K"
  NonPagedMemory="true"
  Stack="true"> 
  <Keywords>
    <Keyword
      Value="0x240000"/>
  </Keywords>
</EventProvider>

<EventProvider
  Id="Search-Core-provider"
  Name="Microsoft-Windows-Search-Core"/>

다음 코드 예제에서는 캡처 상태 공급자를 정의합니다.

<EventProvider Id="sample-provider" Name="SampleProvider" NonPagedMemory="true" Level="5">
  <Keywords>
    <Keyword Value="0x98"/> <!-- Provider is enabled with these keywords throughout the tracing session. -->
  </Keywords>
  <CaptureStateOnStart>
    <Keyword Value="0xff4"/> <!-- Provider is enabled with these keywords when tracing is started. -->
  </CaptureStateOnStart>
  <CaptureStateOnSave>
    <Keyword Value="0x118"/> <!-- Provider is enabled with these keywords when tracing is saved. -->
  </CaptureStateOnSave>
</EventProvider>

<EventProvider Id="EventProvider_DWMWin32k_CaptureState" Name="e7ef96be-969f-414f-97d7-3ddb7b558ccc" NonPagedMemory="true" CaptureStateOnly="true" > 
  <!-- CaptureStateOnly="true" means that provider is not enabled throughout the tracing session. -->
  <CaptureStateOnSave>
    <Keyword Value="0x80000"/> <!-- Provider is enabled with these keywords when tracing is saved. -->
  </CaptureStateOnSave>
</EventProvider>

관리형 시나리오의 경우 다음 이벤트 공급자 정의를 사용합니다.

<EventCollectorId Value ="ExampleEventCollector">
  <EventProviders>
    <EventProviderId Value="EventProvider_DotNetProvider" /> <!-- You can use this provider in the profile definition because the provider is declared in the built-in profile -->
    <EventProviderId Value="Another_Example_Provider" />
    </EventProvider>
  </EventProviders>
</EventCollectorId>

관련 항목

요소