Profil

Artikel
06/19/2023

Stellt eine Sammlung von Problemkategorien und Sammlerelementen dar.

Elementhierarchie

<WindowsPerformanceRecorder>
- <Profile>
  - <Profile>

Syntax

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

Attribute und Elemente

Attribute

attribute	BESCHREIBUNG	Datentyp	Erforderlich	Standard
Id	Identifiziert das Profil eindeutig.	Zeichenfolge, die aus mindestens einem Zeichen bestehen muss und keine Doppelpunkte oder Leerzeichen enthalten darf.	Yes
Name	Gibt den Namen des Profils an.	Zeichenfolge	Ja
Beschreibung	Gibt die Beschreibung des Profils an.	Zeichenfolge	Ja
Base	Gibt die Basis des Profils an.	Zeichenfolge	No
LoggingMode	Gibt an, ob WPR in den Speicher oder in eine sequentielle Datei schreibt.	Dieses Attribut kann einen der folgenden Werte annehmen: Datei Arbeitsspeicher	Ja	Datei
DetailLevel	Gibt an, ob eine Profildefinition für die zeitliche Verfolgung (`Light`) oder die Analyseverfolgung (`Verbose`) verwendet wird.	Dieses Attribut kann einen der folgenden Werte annehmen: Ausführlich Leicht	Ja	Ausführlich
Strict	Gibt an, ob der Ausfall eines Anbieters oder Sammlers den Startvorgang fehlschlagen lässt. Wenn dieses Attribut auf `false` festgelegt ist, ist der Startvorgang erfolgreich, auch wenn einige Sammler oder Anbieter ausfallen. Mindestens ein Sammler und ein Anbieter müssen erfolgreich sein, damit der Vorgang fortgesetzt werden kann. Wenn dieses Attribut auf `true` festgelegt ist, werden Informationen über Anbieter oder Sammler, die nicht gestartet werden konnten, als Warnungen statt als Fehler ausgegeben.	boolean	Nein	false
Intern	Gibt an, ob das Profil intern ist.	boolean	Nein	false
Standard	Gibt an, ob das Profil ein Standardprofil ist.	boolean	Nein	false

Untergeordnete Elemente

Element	BESCHREIBUNG	Anforderung
ProblemCategories	Stellt eine Sammlung von Problemkategorien dar.	Erforderlich, genau 1.
Collectors	Stellt eine Sammlung von Sammlern für das Profil dar.	Erforderlich, genau 1.
TraceMergeProperties	Stellt eine Sammlung von Trace-Merge-Eigenschaften dar.	Optional, genau 1.

Übergeordnete Elemente

Element	Beschreibung
Profiles	Stellt eine Sammlung von Sammlern, Anbietern und Profilen dar.

Bemerkungen

Jede .wprp-Datei enthält normalerweise mindestens zwei Profildefinitionen: eine für jeden Protokollierungsmodus. Die Ausnahme ist, dass Ein/Aus-Übergangsprofile nur in einer Datei protokolliert werden können, so dass die .wprp-Datei für diese Profile nur eine Profildefinition enthalten kann. Jede .wprp-Datei kann maximal vier Profile enthalten: eines für jede Kombination von Protokollierungsmodus und Detailebene. Alle Profile in einer einzigen .wprp-Datei müssen den gleichen Wert für das Attribut Name haben.

Erstellen Sie den Wert des Attributs Id, indem Sie die Werte der Attribute Name, DetailLevel und LoggingMode getrennt durch Punkte, kombinieren, wie im folgenden Beispiel gezeigt.

Abgeleitete Profile haben standardmäßig alle Attribute des Basisprofils. Diese können überschrieben werden, indem sie im abgeleiteten Profil explizit angegeben werden. Weitere Informationen finden Sie unter Vererbung.

Beispiel

Das folgende Codebeispiel zeigt eine Profildefinition.

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

Sammler und Anbieter können auch an Ort und Stelle, innerhalb der Profildefinition, definiert werden.

Elemente