Поделиться через

Профиль

  • Статья

Представляет коллекцию проблемных категорий и элементов сборщика.

Иерархия элементов

Синтаксис

<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 Уникально идентифицирует профиль. Строка, которая должна содержать по крайней мере один символ и не может содержать двоеточия или пробелы. Да
имя; Указывает имя профиля. строка Да
Описание Указывает описание профиля. строка Да
Базы Указывает основание профиля. строка Нет
LoggingMode Указывает, выполняет ли WPR запись в память или в последовательный файл. Этот атрибут может иметь одно из следующих значений:
  • File
  • Память
 Да Файл
DetailLevel Указывает, используется ли определение профиля для трассировки времени (Light) или трассировки анализа (Verbose). Этот атрибут может иметь одно из следующих значений:
  • Подробный
  • Светлая
 Да Подробный
Strict Указывает, является ли сбой поставщика или сборщика причиной сбоя операции запуска. Если для этого атрибута задано значение false, операция запуска завершается успешно, даже если некоторые сборщики или поставщики завершаются ошибкой. Для продолжения операции должен быть выполнен по крайней мере один сборщик и один поставщик. Если для этого атрибута задано значение true, сведения о поставщиках или сборщиках, которые не удалось запустить, предоставляются в виде предупреждений, а не ошибок. Логическое Нет false
Внутренний Указывает, является ли профиль внутренним. Логическое Нет false
Default Указывает, является ли профиль профилем по умолчанию. Логическое Нет false

Дочерние элементы

Элемент Описание Требование
Категории проблем Представляет коллекцию категорий проблем. Обязательный, ровно 1.
Сборщики Представляет коллекцию сборщиков для профиля. Обязательный, ровно 1.
TraceMergeProperties Представляет коллекцию свойств слияния трассировки. Необязательно, ровно 1.

Родительские элементы

Элемент Описание
Profiles Представляет коллекцию сборщиков, поставщиков и профилей.

Комментарии

Каждый WPRP-файл обычно содержит по крайней мере два определения профиля: по одному для каждого режима ведения журнала. Исключением является то, что профили перехода включено и выключено могут быть зарегистрированы только в файле, поэтому WPRP-файл для этих профилей может содержать только одно определение профиля. Каждый WPRP-файл может содержать не более четырех профилей: по одному для каждого сочетания режима ведения журнала и уровня детализации. Все профили в одном WPRP-файле должны иметь одинаковое значение атрибута Name .

Создайте значение атрибута Id путем объединения значений атрибутов Name, DetailLevel и LoggingMode , разделенных точками, как показано в следующем примере.

Производные профили по умолчанию имеют все атрибуты базового профиля. Их можно переопределить, явно указав их в производном профиле. Дополнительные сведения см. в разделе Наследование.

Пример

В следующем примере кода показано определение профиля.

<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>

Сборщики и поставщики также могут быть определены в определении профиля.

Elements (XElement Dynamic Property) (Elements (Динамическое свойство XElement))