StackEventNameFilters

StackEventNameFilters 要素は、トレース ログ プロバイダーに含めるか、スタックウォーク イベントを除外するイベント名を指定します。

Note

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

要素の階層

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

構文

<StackEventNameFilters FilterIn = "true|false" Operation = "Set|Add|Remove" >

  <!-- Child elements -->
  <EventName>

</StackEventNameFilters>

属性および要素

属性

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

子要素

要素	説明	要件
EventName	トレース ログ イベント名。	必須、1 つ以上。

親要素

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

注記

プロバイダーに対してスタック ウォークが有効になっている場合、プロバイダーによって生成されたすべてのイベントに対してスタックがキャプチャされます。 ほとんどの場合、ユーザーは特定の数のイベントからのみスタックに関心があります。

この要素を使用すると、イベント ID に基づいてイベントの一覧でスタック ウォークを有効または無効にできます。

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

例

    <EventProvider Id="EventProvider_TraceLogGen" Name="*TraceLogGen">
      <StackEventNameFilters FilterIn="true" Level="5">
        <Keyword Value="0x10000000000000"/>
        <EventName Value="Preset1"/>
        <EventName Value="Preset2"/>
      </StackEventNameFilters>
    </EventProvider>

関連トピック

要素