StackKeywordLevelFilter

StackKeywordLevelFilter 要素は、スタックウォーク イベントを含めるか除外するイベント キーワードとレベルを指定します。

注意

Windows 10 バージョン 1709 以降で使用できます。

要素の階層

• < WindowsPerformanceRecorder>
  • < プロファイル>
    • < EventProvider>
      • < StackKeywordLevelFilter>
    • < Profile>
      • < コレクター>
        • < EventCollectorId>
          • < EventProviders>
            • < EventProvider>
              • < StackKeywordLevelFilter>

構文

<StackKeywordLevelFilter FilterIn = "true|false" Level = "unsigned byte" Operation = "Set|Add|Remove" >

  <!-- Child elements -->
  <keyword>

</StackKeywordLevelFilter>

属性および要素

属性

属性	説明	データ型	必須	Default
FilterIn	指定したスタックウォーク イベントを含めるか除外するかを示します。	boolean	はい
Level	イベント レベル	符号なしバイト	いいえ
操作	キーワードを設定するか、追加するかを示します。	この属性は、次のいずれかの値になります。 オン 追加 削除	いいえ	オン

子要素

要素	説明	要件
Keyword	イベント キーワード (keyword)	必須

親要素

要素	説明
EventProvider	プロファイルのイベント プロバイダーを表します。

注記

プロバイダーに対してスタック ウォークが有効になっている場合、プロバイダーによって生成されたすべてのイベントに対してスタックがキャプチャされます。 ほとんどの場合、ユーザーは特定の数のイベントからのスタックにのみ関心があります。 この要素を使用すると、キーワード (keyword)とレベルに基づいてスタック ウォーキングを有効または無効にできます。

ETW では強力なペイロードと属性のフィルター処理がサポートされていますが、CPU オーバーヘッドを減らすには、主にフィルター処理ベースのスコープ フィルターまたはレベルとキーワード (keyword)を使用してイベントをフィルター処理する必要があります。

例

    <EventProvider Id="EventProvider_TraceLogGen" Name="*TraceLogGen">
      <StackKeywordLevelFilter FilterIn="true" Level="5">
        <Keyword Value="0x10000000000000"/>
      </StackKeywordLevelFilter>
    </EventProvider>

関連トピック

要素