WPR-How-to-Themen

Artikel
06/20/2023

In diesem Abschnitt wird beschrieben, wie Prozeduren mithilfe der Windows Performance Recorder (WPR)-Benutzeroberfläche ausgeführt werden. Informationen zum Starten einer Aufzeichnung über die Befehlszeile finden Sie unter WPR-Befehlszeilenoptionen.

Starten einer Aufzeichnung

Klicken Sie auf dem Bildschirm Start auf Windows Performance Recorder.
Um das Standardprofil auszuführen, klicken Sie auf Start. Oder klicken Sie zum Anzeigen und Verwenden anderer Profile auf Weitere Optionen.
1. Wählen Sie im Feld Profile für Leistungsaufzeichnung auswählen mindestens ein Profil aus.
2. Sie können optional ein benutzerdefiniertes Profil hinzufügen. Klicken Sie dazu auf Profile hinzufügen, navigieren Sie zum gewünschten Profil und klicken Sie dann auf Öffnen. Wählen Sie unter Benutzerdefinierte Messungen das Profil aus.
3. Wählen Sie in der Dropdown-Liste Leistungsszenario das gewünschte Szenario aus. Wenn die Aufzeichnung nicht für ein Ein/Aus-Szenario ist, wählen Sie Allgemein aus.
4. Sie können optional auf der leicht Detailebene aufnehmen. (Ausführlich ist die Standardstufe.) Wählen Sie dazu Leicht in der Dropdown-Liste Detailstufe aus.
5. Um die Aufzeichnung in einer Datei zu protokollieren, wählen Sie Datei in der Dropdown-Liste Protokollierungsmodus. Speicher ist der Standardprotokollierungsmodus, mit Ausnahme von Ein/Aus-Übergangsprotokollen, die in einer Datei protokolliert werden müssen.
  
  Achtung Für längere Aufnahmen wählen Sie Speicher. Wenn Sie Datei auswählen, kann die Datei sehr groß werden, da die einzige Beschränkung der Dateigröße der verfügbare Speicherplatz ist. Windows Performance Analyzer (WPA) kann extrem große Dateien nicht analysieren.
Klicken Sie auf Start, um mit der Aufnahme zu beginnen, oder auf Abbrechen, um ohne Aufnahme zu beenden.

Hinweis Wenn Sie versuchen, eine Aufzeichnung in WPR zu starten, während eine andere von WPR initiierte Sitzung ausgeführt wird, erkennt WPR einen Konflikt und fordert Sie mit der folgenden Abfrage auf:

An existing session is already running. Click OK to stop the running session and start the selected profile(s) or Cancel to abort the operation.

Um die aktuelle Sitzung zu beenden, klicken Sie auf OK. WPR beginnt mit der Aufzeichnung. Beachten Sie, dass sich diese Aktion auf die Anwendung auswirken kann, die die abgebrochene Sitzung gestartet hat. Um die Fortsetzung der aktuellen Sitzung zuzulassen, klicken Sie auf Abbrechen. In diesem Fall startet WPR keine Aufzeichnung und die andere Anwendung ist nicht betroffen.

Anzeigen des Aufzeichnungsstatus

Wenn Sie eine Aufzeichnung über die WPR-Benutzeroberfläche (UI) starten, wird der Aufzeichnungsstatus sofort auf dem WPR-Bildschirm angezeigt. Wenn Sie eine Aufzeichnung über die WPR-Befehlszeilenschnittstelle starten, können Sie den Aufzeichnungsstatus mit einer der folgenden Methoden anzeigen:

Geben Sie im Eingabeaufforderungsfenster wpr –status ein. Weitere Informationen zu diesem Befehl finden Sie unter WPR-Befehlszeilenoptionen.
Öffnen Sie die WPR-Benutzeroberfläche. Der Status der Aufzeichnung, die Sie über die WPR-Befehlszeile gestartet haben, wird angezeigt.

Hinweis WPR kann den Status einer Aufzeichnung nur anzeigen, wenn die Aufzeichnung von WPR gestartet wurde. Der Aufzeichnungsstatus für Aufzeichnungen, die von Xperf oder anderen Anwendungen gestartet wurden, kann nicht angezeigt werden.

Der Aufzeichnungsstatus zeigt die folgenden Informationen an:

Aufnahmezeit: Dies ist die Zeitdauer, die die Aufnahme läuft.
Puffer: Dies ist die Puffergröße, die die Aufzeichnung verwendet. Er wird sowohl in MB als auch in Prozent des verfügbaren gepoolten Speichers angezeigt.
Verworfene Ereignisse: Die Anzahl der verlorenen Ereignisse seit Beginn der Aufzeichnung. Weitere Informationen zu diesem Problem finden Sie unter Vermeidung verlorener Ereignisse.

Beenden einer Aufzeichnung

Klicken Sie auf dem WPR-Bildschirm auf Speichern. (Wenn Sie auf Abbrechen klicken, werden keine Aufnahmedaten gespeichert.)
Navigieren Sie zu dem Ort, an dem Sie die Aufnahmedatei speichern möchten.
Geben Sie eine Beschreibung des Problems ein, für das Sie die Aufzeichnung erstellt haben.
Klicken Sie auf Speichern und dann auf OK.

Wenn Ereignisse verloren gegangen sind, wird eine Warnung angezeigt. Eine Anleitung zur Vermeidung dieses Problems finden Sie unter Vermeiden von verlorenen Ereignissen.

Sicherheit

Aufzeichnungen können personenbezogene oder sicherheitsrelevante Informationen enthalten. Dazu gehören Pfade zu Dateien, auf die die Aufzeichnung zugreift, oder Registrierungszugriffs- und Prozessnamen. Seien Sie vorsichtig, wenn Sie Aufnahmedateien teilen.

Hinzufügen und Entfernen von benutzerdefinierten Aufzeichnungsprofilen

Wenn die Optionen auf dem WPR-Bildschirm ausgeblendet sind, klicken Sie auf Weitere Optionen.
Klicken Sie auf Profile hinzufügen.
Navigieren Sie zu dem Speicherort, der die Profildateien enthält, wählen Sie die .wprp-Datei aus und klicken Sie dann auf Öffnen. WPR überprüft das Schema der WPRP-Datei, bevor sie dem Profil hinzugefügt wird.
Wiederholen Sie die Schritte 2 und 3, um weitere Profile hinzuzufügen. Sie können bis zu 64 Profile für eine einzelne Aufnahme verwenden.

Die von Ihnen hinzugefügten Profile werden unter Benutzerdefinierte Messungen angezeigt.

Zum Entfernen eines Aufnahmeprofils

Wenn die Optionen auf dem WPR-Bildschirm ausgeblendet sind, klicken Sie auf Weitere Optionen.
Klicken Sie mit der rechten Maustaste auf das benutzerdefinierte Profil, das Sie entfernen möchten, und klicken Sie dann auf Profil entfernen.

Die Schaltfläche Profil entfernen ist nur sichtbar, wenn benutzerdefinierte Profile vorhanden sind. Sie können nur benutzerdefinierte Profile entfernen: Sie können keine integrierten Profile entfernen.

Ändern des Leistungsszenarios

Wenn die Optionen auf dem WPR-Bildschirm ausgeblendet sind, klicken Sie auf Weitere Optionen.
Wählen Sie in der Dropdown-Liste Leistungsszenario das gewünschte Szenario aus. Der Standardwert ist Allgemein.

Ändern der Detailstufe

Wenn die Optionen auf dem WPR-Bildschirm ausgeblendet sind, klicken Sie auf Weitere Optionen.
Wählen Sie in der Dropdown-Liste Detailebene die gewünschte Detailebene aus. Ausführlich ist die Standardstufe.

Ändern des Protokollierungsmodus

Klicken Sie auf dem Start-Bildschirm von Windows 8 auf Windows Performance Recorder.
Klicken Sie auf Weitere Optionen.
Wählen Sie den Protokollierungsmodus aus der Dropdown-Liste Protokollierungsmodus aus. Der Standardmodus ist Memory.

Achtung Für längere Aufnahmen wählen Sie Speicher. Wenn Sie Datei auswählen, kann die Datei sehr groß werden, da der verfügbare Speicherplatz die einzige Beschränkung der Dateigröße darstellt. Wenn die Datei zu groß ist, können Sie sie möglicherweise nicht in Windows Performance Analyzer (WPA) analysieren.

Erstellen von benutzerdefinierten Aufzeichnungsprofilen

Sie können benutzerdefinierte Profile in einer XML-Datei mit der Erweiterung .wprp erstellen. Siehe Aufzeichnungsprofil-XML-Referenz für das vollständige Schema und Referenzinformationen. Ausführlichere Informationen zum Erstellen von Aufzeichnungsprofilen finden Sie unter Erstellen von Aufzeichnungsprofilen.

So erstellen Sie ein benutzerdefiniertes Aufzeichnungsprofil

Erstellen Sie in einem XML-Editor eine neue XML-Datei.
Definitionen für Collector eingeben. Weitere Informationen finden Sie unter 1. Definitionen für Collector.
System- und Ereignisanbieterdefinitionen eingeben. Weitere Informationen finden Sie unter 2. System- und Ereignisanbieterdefinitionen.

Hinweis Wenn das benutzerdefinierte Profil beendet und zurückgesetzt werden soll, wenn einige Anbieter nicht beginnen, legen Sie das Strict-Attribut auf „true“ fest. Weitere Informationen zu dieser Option finden Sie unter Strict Providers.

Profildefinitionen eingeben. Weitere Informationen finden Sie unter 3. Profildefinitionen.
Speichern Sie die Datei mit der Erweiterung .wprp.

Sie können abgeleitete Kollektoren, Anbieter und Profile definieren, die von einer Basisversion erben, die Sie zuvor in derselben Datei oder in einer anderen Datei definiert haben. Weitere Informationen zu dieser Option finden Sie unter Vererbung.

Vermeiden verlorener Ereignisse

Einige Anwendungen erzeugen so viele Ereignisse, dass die Ereignisverfolgung für Windows (ETW) nicht mit der Protokollierungsfrequenz Schritt halten kann. Dieses Problem manifestiert sich als verlorene Ereignisse in den Aufzeichnungen. Das Problem kann aufgrund unvollständiger Daten zu Analyseschwierigkeiten oder fehlerhaften Schlussfolgerungen führen.

Hinweis Standardmäßig verwendet WPR ausgelagerten Speicher für Puffer. Um festzulegen, dass WPR nicht ausgelagerten Speicher für Puffer verwendet, legen Sie das NonPagedMemory-Attribut für den Anbieter auf true fest. Weitere Informationen zum Erstellen eines benutzerdefinierten Profils finden Sie unter Erstellen von Aufzeichnungsprofilen und 2. System- und Ereignisanbieterdefinitionen.

Sie können auf folgende Weise verhindern, dass WPR ETW-Puffer oder -Ereignisse verliert:

Verwenden Sie größere Puffer, um eine effizientere Datenträger-E/A zu ermöglichen, wenn WPR die Puffer auf den Datenträger schreibt.
Zählen Sie Anforderungen für die Datensammlung, wenn Sie eine bestimmte Pufferkonfiguration zum ersten Mal auf einem Computer verwenden.
Verwenden Sie die Befehlszeilenoption recordTempTo, um einen anderen Speicherort als die Standardeinstellung aufzuzeichnen.
Erhöhen der Anzahl der Meldungen.
Vereinfachen Sie das Szenario, das Sie testen, oder wählen Sie weniger Profile aus.
Freier Speicherplatz auf dem Systemlaufwerk.
Verwenden Sie fortschrittliche Hardware, um die Daten zu sammeln; Verwenden Sie beispielsweise ein Festplattensubsystem mit höherem Durchsatz. Dies ist die letzte zu berücksichtigende Option. Normalerweise können Sie den Verlust von Ereignissen vermeiden, indem Sie die zu aktivierenden Anbieter und die zu verwendenden Puffer sorgfältig auswählen.