配置文件

表示问题类别和收集器元素的集合。

元素层次结构

• < WindowsPerformanceRecorder>
  • < Profiles>
    • < 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>

特性和元素

特性

属性	说明	数据类型	必须	默认
Id	唯一地标识配置文件。	字符串，必须至少包含一个字符，且不能包含冒号或空格。	是
名称	指示配置文件的名称。	string	是
说明	指示配置文件的说明。	字符串	是
Base	指示配置文件的基。	字符串	否
LoggingMode	指示 WPR 是写入内存还是写入顺序文件。	此属性可以具有以下值之一： 文件 内存	是	文件
DetailLevel	指定配置文件定义是用于计时跟踪 (Light) 还是分析跟踪 (Verbose)。	此属性可以具有以下值之一： 详细 亮	是	详细
Strict	指示提供程序或收集器失败是否会导致启动操作失败。 如果此属性设置为 false，则即使某些收集器或提供程序失败，启动操作也会成功。 必须至少有一个收集器和一个提供程序成功，操作才能继续。 如果此属性设置为 true，则有关未能启动的提供程序或收集器的信息将作为警告提供，而不是作为错误提供。	boolean	否	false
内部	指示配置文件是否是内部配置文件。	boolean	否	false
Default	指示配置文件是否是默认配置文件。	boolean	否	false

子元素

元素	说明	要求
ProblemCategories	表示问题类别的集合。	必需，正好为 1。
Collectors	表示配置文件的收集器集合。	必需，正好为 1。
TraceMergeProperties	表示跟踪合并属性的集合。	可选，正好为 1。

父元素

元素	说明
Profiles	表示收集器、提供程序和配置文件的集合。

注解

每个 .wprp 文件通常至少包含两个配置文件定义：每个日志记录模式一个。 例外情况是，开/关转换配置文件只能记录到文件中，因此这些配置文件的 .wprp 文件只能包含一个配置文件定义。 每个 .wprp 文件最多只能包含四个配置文件：每个记录模式和详细信息级别组合有一个配置文件。 一个 .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>

还可以在配置文件定义中就地定义收集器和提供程序。

相关主题

元素