プロファイル

問題カテゴリおよびコレクター要素のコレクションを表します。

要素の階層

• < WindowsPerformanceRecorder>
  • < プロファイル>
    • < Profile>

構文

<Profile Id          = IdType
         Name        = string
         Description = string
         Base        = string
         LoggingMode = "File" | "Memory"
         DetailLevel = "Verbose" | "Light"
         Strict      = boolean
         Internal    = boolean
         Default     = boolean>

  <!-- Child elements -->
  ProblemCategories,
  Collectors

</Profile>

属性および要素

属性

属性	説明	データ型	必須	Default
Id	プロファイルを一意に識別します。	少なくとも 1 つの文字を含み、コロンやスペースを含めることができない文字列。	はい
名前	プロファイルの名前を示します。	string	はい
説明	プロファイルの説明を示します。	string	はい
Base	基本のプロファイルを示します。	string	いいえ
LoggingMode	WPR がメモリまたはシーケンシャル ファイルに書き込むかどうかを示します。	この属性は、次のいずれかの値になります。 ファイル メモリ	はい	ファイル
DetailLevel	タイミング トレース (Light) または分析トレース (Verbose) にプロファイル定義を使用するかどうかを指定します。	この属性は、次のいずれかの値になります。 "詳細" 白	はい	"詳細"
Strict	プロバイダーまたはコレクターのエラーによって開始操作が失敗するかどうかを示します。 この属性が false に設定されている場合、一部のコレクターまたはプロバイダーにエラーが発生しても、開始操作は成功します。 操作を続けるには、少なくとも 1 つのコレクターと 1 つのプロバイダーが成功している必要があります。 この属性が true に設定されている場合、開始に失敗したプロバイダーまたはコレクターに関する情報は、エラーではなく警告として表示されます。	boolean	いいえ	false
内部	プロファイルが内部用であるかどうかを示します。	boolean	いいえ	false
既定	プロファイルが既定のプロファイルであるかどうかを示します。	boolean	いいえ	false

子要素

要素	説明	要件
ProblemCategories	問題カテゴリのコレクションを表します。	必須。1 つのみ。
Collectors	プロファイルのコレクターのコレクションを表します。	必須。1 つのみ。
TraceMergeProperties	トレース マージ プロパティのコレクションを表します。	オプション、1 つのみ。

親要素

要素	説明
Profiles	コレクター、プロバイダー、プロファイルのコレクションを表します。

注釈

各 .wprp ファイルには、通常、少なくとも 2 つのプロファイル定義 (ログ モードごとに 1 つ) が含まれています。 例外として、オン/オフ切り替えプロファイルはファイルにのみ記録できるため、これらのプロファイルの .wprp ファイルにはプロファイル定義を 1 つだけ含めることができます。 各 .wprp ファイルには、最大 4 つのプロファイル (ログ モードと詳細レベルの組み合わせごとに 1 つ) を含めることができます。 1 つの .wprp ファイル内のすべてのプロファイルは、Name 属性が同じ値である必要があります。

次の例に示すように、Name、DetailLevel、LoggingMode の各属性値をピリオドで区切って組み合わせて、Id 属性値を構成します。

派生プロファイルには、既定で基本プロファイルのすべての属性が含まれます。 これらは、派生プロファイルで明示的に指定することによってオーバーライドできます。 詳細については、「継承」を参照してください。

例

次のコード例は、プロファイル定義を示しています。

<Profile
  Id="Example.Light.File"
  Name="Example"
  DetailLevel="Light"
  LoggingMode="File"
  Description="Example profile">
  <ProblemCategories>
    <ProblemCategory
      Value="First Level Triage"/>
  </ProblemCategories>
  <Collectors>
    <SystemCollectorId
      Value="WPRSystemCollector">
    <SystemProviderId
      Value="system-provider"/>
    </SystemCollectorId>
    <EventCollectorId
      Value="WPREventCollector">
      <EventProviders>
        <EventProviderId
          Value="Win32K-provider"/>
        <EventProviderId
          Value="Search-Core-provider"/>
      </EventProviders>
    </EventCollectorId>
  </Collectors>
</Profile>

コレクターとプロバイダーは、プロファイル定義内にインプレースで定義することもできます。

関連トピック

要素