Verwenden von PDB-Dateien mit der NGEN-Unterstützung von CLR 4.0

Sowohl Xperf als auch Windows Performance Recorder (WPR) können mit aktiviertem Common Language Runtime (CLR) 4.0 Native Image Generator (NGEN) PDB ausgeführt werden.

Hinweis WPR verarbeitet CLR-Symbole direkt, sodass keine Flags beim Konfigurieren und Verwenden der NGEN-Unterstützung erforderlich sind.

Wenn Sie eine Aufzeichnung in der WPR-Benutzeroberfläche (UI) starten, werden NGEN-Programmdatenbankdateien (PDBs) neben der gespeicherten Aufzeichnung generiert. Diese PDBs decodieren Symbole von Modulen, die mithilfe von NGEN für verwaltete Szenarien erstellt wurden. Für Recording.etl befinden sich die NGEN-PDBs im Ordner Recording.etl.NGENPDB.

Verwenden der NGEN-Unterstützung mit WPR

Es wird empfohlen, die folgende Einrichtung vor dem Ausführen von WPR mit aktivierter NGEN-Unterstützung auszuführen:

• (Optional, aber empfohlen) Festlegen der Umgebungsvariable SymCache auf ein lokales Verzeichnis

Verwenden der NGEN-Unterstützung mit Xperf

Gehen Sie wie folgt vor, um die NGEN-Unterstützung mit Xperf zu verwenden:

1. Geben Sie an einer Eingabeaufforderung mit erhöhten Rechten Folgendes ein:

   set _NT_SYMBOL_PATH=srv*C:\Symbols.NGEN;srv*https://msdl.microsoft.com/download/symbols
   

2. Geben Sie Folgendes ein, um die Kernelsitzung zu starten:

   xperf -on Base -stackwalk Profile -f kernel.etl
   

3. Geben Sie Folgendes ein, um die CLR-Laufzeitsitzungsaufzeichnung zu starten:

   xperf -start ClrSession -on ClrAll:0x98:5 -f clr.etl -buffersize 128 -minbuffers 256 -maxbuffers 512
   

4. Führen Sie Ihr Szenario aus.

5. Geben Sie Folgendes ein, um die CLR-Ausführungssitzung zu starten:

   xperf -start ClrRundownSession -on ClrAll:0x118:5+a669021c-c450-4609-a035-5af59af4df18:0x118:5 -f clr_DCend.etl -buffersize 128 -minbuffers 256 -maxbuffers 512
   

6. Geben Sie Folgendes ein, um die Laufzeit für CLR-Ausführung abzuschließen, indem Sie das Timeout auf 15 festlegen:

   timeout /t 15
   

7. Geben SieFfolgendes ein, um die CLR-Laufzeitsitzung, die CLR-Rundown-Sitzung und die Kernelsitzung zu beenden, und fügen Sie sie in eine einzelne Datei zusammen:

   xperf -stop ClrSession ClrRundownSession -stop -d recording.etl
   

Decodierung einer Aufzeichnung, die CLR 4.0 NGEN PDB-Unterstützung aktiviert hat

Geben Sie an einer Eingabeaufforderung mit erhöhten Rechten Folgendes ein:

set _NT_SYMBOL_PATH=srv*C:\Symbols.NGEN;srv*https://msdl.microsoft.com/download/symbols

Übertragen einer Aufzeichnung, die CLR 4.0 NGEN PDB-Unterstützung aktiviert hat

Um eine Aufzeichnung mit CLR 4.0 NGEN PDB zu übertragen, die aktiviert ist, schließen Sie Folgendes in den Symbolpfad ein:

srv*C:\Symbols.NGEN

Um die Aufzeichnung auf einen anderen Computer zu übertragen, stellen Sie sicher, dass sowohl Recording.etl als auch der gesamte Ordner C:\Symbols.NGEN (zusammen mit seinen Unterordnern) übertragen werden.

Zugehörige Themen

Symbolunterstützung

symbols