Freigeben über

Profil

  • Artikel

Stellt eine Sammlung von Problemkategorien und Sammlerelementen dar.

Elementhierarchie

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