Opzioni della riga di comando WPR
Windows Performance Recorder (WPR) offre una semplice interfaccia della riga di comando. La complessità completa di WPR è incorporata nei profili di registrazione.
Opzioni generali
WPR richiede il sistema operativo Windows 8.1 o versione successiva.
Sintassi
wpr FirstLevelOption [<arguments>] [Additional options [<arguments>]]
È possibile ottenere assistenza aggiuntiva con:
wpr -help [start | stop | status | profiles | providers | tracing | boottrace | heap | hardwarecounter | advanced]
Sono disponibili le opzioni FirstLevelOptions seguenti:
Opzione | Descrizione |
---|---|
-help | Specificare l'elenco delle informazioni della Guida di livello secondario. |
-Profili | Enumera i nomi dei profili e le descrizioni di un profilo. |
-purgecache | Elimina la cache dei simboli dinamici. |
-inizio | Avvia uno o più profili. |
-marcatore | Genera un marcatore di evento. |
-markerflush | (Obsoleto) Genera un marcatore di evento e scarica il working set. |
-stato | Visualizza lo stato di una registrazione attiva (se presente). |
-profiledetails | Genera un marcatore di evento e scarica il working set. |
-exportprofile | esportare il profilo predefinito in un file. |
-Provider | Visualizza informazioni dettagliate sui provider. |
-cancel | Annulla la registrazione avviata da WPR (se presente). |
-fermarsi | Annulla e salva la registrazione avviata da WPR (se presente). |
-fondersi | Unisce i file etl nel file specificato. |
-sciacquone | Scarica le sessioni di registrazione avviate da WPR (se presenti). |
-log | Configura le informazioni di debug salvate nel registro eventi. |
-disablepagingexecutive | Modifica le impostazioni Disabilita paging Executive . |
-heaptracingconfig | Modifica le impostazioni di traccia dell'heap di un processo. |
-snapshotconfig | Modificare le impostazioni dello snapshot per un processo. |
-capturestateondemand | Acquisisce gli stati dei provider configurati nella registrazione corrente. |
-pmcsources | Esegue una query sull'elenco degli eventi PMU disponibili nel sistema. |
-pmcsessions | Eseguire una query sull'elenco delle sessioni usando gli eventi PMU. |
-setprofint | Imposta l'intervallo del profilo campionato. |
-profint | Esegue una query sull'intervallo di profilo corrente. |
-resetprofint | Ripristina i valori predefiniti dell'intervallo del profilo. |
-boottrace | Configura le voci del Registro di sistema per le sessioni autologger/globallogger. |
-enableperiodicsnapshot | Abilita snapshot periodico per l'intervallo specificato e l'ID del processo specificato. |
-disableperiodicsnapshot | Disabilita lo snapshot periodico per tutto il processo. |
-singlesnapshot | Ottiene uno snapshot su richiesta per il processo specificato. |
Profili
L'opzione Profili elenca i profili WPR usati dalla registrazione.
Sintassi
wpr -profiles [<path>]
Nella tabella seguente vengono descritti gli argomenti disponibili che è possibile applicare a questa opzione. Per visualizzare i profili predefiniti, omettere l'argomento .
Argomento | Descrizione |
---|---|
<path> | Specifica il percorso e il nome del file che contiene le definizioni del profilo. Ad esempio: wpr -profiles “c:\Users\User1\Documents\WPR Files\Custom Profiles\CustomProfile1.wprp” |
Inizio
L'opzione Start avvia una registrazione usando uno o più profili.
Sintassi
wpr -start <profile> [-start <profilen>]... [-filemode] [-recordtempto <temp folder path>] [-onoffscenario <OnOff Transition Type>] [-onoffresultspath <path to which the trace files are saved>] [-onoffproblemdescription <description of the scenario>] [-numiterations <number of iterations for OnOff tracing>]
Nella tabella seguente vengono descritte le opzioni disponibili che è possibile applicare a questa opzione.
Switch | Descrizione |
---|---|
<profilo> [-start< profilen>]... | Specifica un profilo predefinito o il percorso di un profilo definito dall'utente. È possibile specificare fino a 64 profili in una singola riga di comando, con ogni profilo specificato nel modo seguente: <profile> := [<filename.wprp>!]<nome> profilo[.{light|verbose}] Ogni profilo può definire versioni leggere o dettagliate o entrambe le versioni. Se non viene specificata alcuna opzione, viene usata la versione dettagliata, a meno che il profilo non includa solo una versione leggera. |
-shutdown [<KSR>] | Specifica che le informazioni e le registrazioni della sessione verranno mantenute durante il riavvio. L'opzione Di arresto funziona solo con la traccia in modalità file in cui KSR funziona solo con la modalità di memoria. Chiamare il comando -stop all'avvio successivo per unire la traccia. |
-filemode | Specifica che la registrazione viene eseguita in modalità file. La modalità predefinita è memoria. Usando questa opzione, i dati vengono registrati in un file non associato, che può aumentare di dimensioni fino a quando non riempie il disco. |
-recordtempto <temp folder path> | Specifica il percorso temporaneo della cartella in cui viene salvata la registrazione. |
Tipo di transizione -onoffscenario <OnOff> | Specifica uno dei tipi di transizione on/off. Questi sono: Avvio, FastStartup, Arresto, RebootCycle, Standby o Ibernazione. |
-onoffresultspath percorso <in cui vengono salvati i file di traccia> | Specifica il percorso in cui vengono salvati i file di traccia. |
-onoffproblemdescription <descrizione dello scenario> | Specifica la descrizione dello scenario. |
-numiterations number of iterations <for OnOff tracing> | Imposta il numero di iterazioni per la registrazione OnOff. Per impostazione predefinita, le impostazioni del file di profilo predefinito o personalizzato vengono usate per impostazione predefinita. |
Esempio
wpr -start CPU (Starts verbose CPU profile in memory mode)
wpr -start CPU.light -filemode (Starts light CPU profile in file mode)
wpr -start filename.wprp!ProfileName.Verbose (Starts verbose ProfileName profile defined in filename.wprp)
Arresta
L'opzione Arresta arresta la registrazione corrente e la salva nel file specificato dall'argomento .
Sintassi
wpr -stop <file> <problem description> -[skipPdbGen] [-force] [-compress]
Nella tabella seguente vengono descritti gli argomenti disponibili che è possibile applicare a questa opzione.
Argomento | Descrizione |
---|---|
<file name> | Specifica il file ETL (Event Trace Log) in cui WPR salva la registrazione. Questo argomento è obbligatorio. |
<descrizione del problema> | Specifica la descrizione del problema. Anche se questo argomento è facoltativo, è consigliabile usarlo. |
-skipPdbGen | Disabilita la generazione dinamica di ngen e pdbs incorporati per i moduli .NET. Questa opzione può ridurre il tempo dell'operazione di arresto. |
-force | Disabilita l'avviso quando l'estensione del file di destinazione non è con estensione etl. |
-comprimere | Comprime il file di traccia di output. |
Unire
L'opzione Merge unisce i file etl nel file specificato.
Sintassi
wpr -merge <trace files ...> <merged file> -[skipPdbGen] [-compress] [-supresspii] [-mergeonly] [-injectonly]
Nella tabella seguente vengono descritti gli argomenti disponibili che è possibile applicare a questa opzione.
Argomento | Descrizione |
---|---|
<file di traccia ...> | Specifica uno o più file di log di traccia eventi (ETL) non uniti. Questo argomento è obbligatorio. |
<file unito> | Specifica il file di output in cui WPR unisce i file ETL. |
-skipPdbGen | Disabilita la generazione dinamica di ngen e pdbs incorporati per i moduli .NET. Questa opzione può ridurre il tempo dell'operazione di arresto. |
-comprimere | Comprime il file di traccia di output. |
-supresspii | Elimina le informazioni personali. |
-mergeonly | Unisce le tracce senza aggiungere informazioni specifiche del computer o eventi id immagine. Non può essere usato con -injectonly. |
-injectonly | Genera solo eventi di ID immagine e/o specifici del computer senza copiare gli eventi originali nel file unito. |
Annulla
L'opzione Annulla annulla la registrazione corrente senza salvare i dati registrati. Se non è attiva alcuna istanza, l'opzione Annulla restituisce un errore.
Sintassi
wpr -cancel
Questa opzione non accetta argomenti.
Status
L'opzione Stato visualizza le informazioni sullo stato relative alla registrazione WPR corrente.
Sintassi
wpr -status [profiles] [collectors [-details]]
Se non è attiva alcuna registrazione, viene visualizzato un messaggio che indica che WPR non è registrato. Se una registrazione è attualmente attiva e non vengono usati argomenti, vengono visualizzate le informazioni sullo stato seguenti:
WPR recording is in progress...
Time since start : 00:04:27
Dropped event : 0
Logging mode : Memory
Se si specificano argomenti insieme all'opzione –status , le informazioni elencate in precedenza vengono visualizzate insieme ai dati specifici di tale opzione. Nella tabella seguente vengono descritti gli argomenti disponibili che è possibile applicare a questa opzione.
Argomento | Descrizione e output di esempio |
---|---|
profiles | Questo argomento elenca ogni profilo utilizzato nella registrazione WPR corrente.
Esempio: Registrazione dell'attività di sistema con il set di profili seguente: |
Collezionisti | Elenca le informazioni dell'agente di raccolta. Se i buffer sono stati persi, tali buffer vengono elencati.
Esempio: Registrazione attiva degli agenti di raccolta: |
details | Elenca informazioni aggiuntive su ogni agente di raccolta. |
Profiledetails
L'opzione Profiledetails visualizza informazioni dettagliate su un profilo o un set di profili. Per specificare più profili, usare la sintassi seguente in cui <profilen> fa riferimento al nome di ogni profilo.
Sintassi
wpr -profiledetails <profile1>+<profile2>+...+<profilen> [-filemode] -onoffscenario <OnOff Transition Type>
Nella tabella seguente vengono descritte le opzioni disponibili che è possibile applicare a questa opzione.
Switch | Descrizione |
---|---|
-filemode | Specifica che la registrazione è stata eseguita in modalità file. La modalità predefinita è memoria. |
Tipo di transizione -onoffscenario <OnOff> | Specifica uno dei tipi di transizione on/off. Questi sono: Avvio, FastStartup, Arresto, RebootCycle, Standby o Ibernazione. |
ExportProfile
L'opzione ExportProfile esporta i profili predefiniti nel file specificato. Usare wpr -Profiles
il comando per enumerare i profili predefiniti disponibili. Per specificare più profili, usare la sintassi seguente in cui <profilen>
fa riferimento al nome di ogni profilo. La convenzione di denominazione dei profili è esattamente la stessa usata in wpr -start
. Un profilo viene specificato come <profile name>[.{light|verbose}]
.
Sintassi
wpr -exportprofile <profile1>+<profile2>+...+<profilen> <ExportedFileName.wprp> [-filemode]
In questo esempio il profilo filemode verbose GeneralProfile viene esportato nel file GeneralProfileVerboseFile.wprp.
Esempio
wpr -exportprofile GeneralProfile d:\profiles\GeneralProfileVerboseFile.wprp -filemode
Provider
L'opzione Provider visualizza informazioni dettagliate sui provider. I provider fanno riferimento ai componenti ETW (Event Tracing for Windows) che espongono eventi a Windows Performance Recorder (WPR). Per visualizzare informazioni sui provider, usare la sintassi seguente, in cui -providers fa riferimento a tutti i provider installati/noti e registrati.
Sintassi
wpr -providers
Questa opzione non accetta argomenti.
Boottrace
L'opzione Boottrace configura le voci del Registro di sistema per le sessioni autologger/globallogger per il profilo specificato.
Sintassi
wpr -boottrace {-addboot [<filename.wprp>!]<profile> [-addboot <profile> ...] [-filemode] [-recordtempto <temp folder path>] | -stopboot <recording filename> <Problem description> | -cancelboot}
Nella tabella seguente vengono descritte le parole chiave disponibili che è possibile applicare a questa opzione.
Argomento | Descrizione |
---|---|
-boottrace | Specifica l'argomento seguente per configurare l'autologger. Nell'attuale WPR questo argomento è facoltativo. |
-addboot | Imposta le voci del Registro di sistema di autologger per il profilo specificato. Il wpr -addboot comando accetta le stesse opzioni del wpr -start comando. Si noti che queste opzioni non avviano immediatamente la traccia. Dopo il riavvio, il programma automatico verrà avviato dal sistema operativo. |
-stopboot | Rimuove l'autologger configurato da addboot, arresta la registrazione di avvio e unisce tutte le registrazioni nel file specificato. Si noti che questa opzione salva la traccia solo se la sessione di autologger è in esecuzione(ad esempio dopo il riavvio). In caso contrario, questa opzione rimuoverà solo la configurazione di autologger. |
-cancelboot | Rimuove l'autologger configurato da addboot e annulla la registrazione di avvio avviata da WPR. |
CaptureStateOnDemand
L'opzione CaptureStateOnDemand acquisisce gli stati per i provider configurati nella registrazione corrente. Il provider di eventi deve essere configurato per capturestateondemand all'interno del file di profilo durante l'esecuzione della sessione.
Sintassi
wpr-capturestateondemand
Di seguito è riportato un esempio di EventProvider:
<EventProvider Id="EventProvider_Microsoft-Windows-Win32k" Name="Microsoft-Windows-Win32k" NonPagedMemory="true" CaptureStateOnly="true">
<CaptureStateOnDemand Timeout="5">
<Keyword Value="0x0"/>
</CaptureStateOnDemand>
</EventProvider>
Marcatore
L'opzione Marcatore attiva un marcatore di evento con il testo specificato nella sessione di registrazione del sistema corrente.
Sintassi
wpr -marker <text> [-flush]
Argomento | Descrizione |
---|---|
-sciacquone | Scarica il working set. Equivalente a -MarkerFlush. |
MarkerFlush (obsoleto)
L'opzione MarkerFlush attiva un marcatore di evento con il testo specificato e scarica il working set. Questo comando è obsoleto in WPR corrente.
Sintassi
wpr -markerflush <text>
Svuotamento
L'opzione Scarica scarica le sessioni di registrazione ai file avviati tramite WPR.
Sintassi
wpr -flush
Questa opzione non accetta argomenti.
HeapTracingConfig
L'opzione HeapTracingConfig abilita o disabilita la traccia dell'heap per un processo o un'applicazione di archiviazione specifica.
Sintassi
wpr -HeapTracingConfig <process name> [<package full name> <package relative app ID>] [{enable|disable}]
Nota
- Se il parametro {enable|disable} viene omesso, verrà visualizzata la configurazione corrente della traccia heap per il processo o l'app. Ad esempio:
wpr -HeapTracingConfig Heaptest.exe enable
- Questo comando non avvia immediatamente la traccia e deve essere eseguito prima di acquisire la traccia dell'heap. Per altri dettagli, vedere Registrazione per l'analisi dell'heap.
- Disabilitare sempre HeapTracingConfig per il processo dopo l'esecuzione della traccia perché può influire sulle prestazioni del processo.
Disablepagingexecutive
L'opzione Disablepagingexecutive specifica se i driver e il codice di sistema in modalità kernel possono essere distribuiti su disco. L'impostazione di questa opzione su su impedisce il paging. Questa opzione imposta il valore di DisablePagingExecutive nel Registro di sistema.
Sintassi
wpr -disablepagingexecutive {on | off}
Nota
Per acquisire correttamente gli stack di eventi in sistemi a 64 bit che eseguono Windows 7, disablepagingexecutive deve essere impostato su Sì e il sistema deve essere riavviato prima di avviare la registrazione delle prestazioni. Per i sistemi a 32 bit che eseguono Windows 7 e per tutti i sistemi che eseguono Windows 8 o versione successiva, è possibile gestire la registrazione delle prestazioni senza impostare disablepagingexecutive su Sì.
Log
L'opzione Log aggiunge e configura la registrazione del debug nel registro eventi.
Sintassi
wpr -log {enabled | disabled | remove}
Nella tabella seguente vengono descritte le parole chiave disponibili che è possibile applicare a questa opzione.
Parola chiave | Descrizione |
---|---|
abilitata | Abilita la registrazione del debug nel registro eventi |
disabile | Disabilita la registrazione del debug nel registro eventi |
remove | Disinstalla il manifesto del provider di registrazione di debug WPR dal sistema |
Purgecache
L'opzione Purgecache elimina la cache dei simboli gestiti.
Sintassi
wpr -purgecache
Questa opzione non accetta argomenti.
Help
Usare questa opzione per visualizzare la Guida in linea nella finestra del prompt dei comandi.
Sintassi
wpr -help [start | stop | status | profiles | providers | tracing | boottrace | heap | hardwarecounter | advanced]
Nella tabella seguente vengono descritte le parole chiave disponibili che è possibile applicare a questa opzione.
Parola chiave | Descrizione |
---|---|
Nessuna parola chiave | Visualizza un elenco di opzioni e descrizioni brevi. Per ottenere altre informazioni su opzioni specifiche, usare una parola chiave . Ad esempio: wpr -help start . |
start | Descrive l'argomento della riga di comando –start . Per altre informazioni, vedere Start. |
stop | Descrive l'argomento -stop, -merge e -cancel della riga di comando. |
status | Descrive gli argomenti della riga di comando -status . Per altre informazioni, vedere Stato. |
profiles | Descrive gli argomenti della riga di comando -profiles, -profiledetails e -exportprofile . |
provider | Descrive l'argomento della riga di comando -providers . Per altre informazioni, vedere Provider. |
tracing | Descrive l'argomento della riga di comando –marker, -flush e -capturestateondemand . |
boottrace | Descrive gli argomenti della riga di comando -addboot, -stopboot e -cancelboot. |
heap | Descrive -heaptracingconfig, -snapshotconfig, -enableperiodicsnapshot, -disableperiodicsnapshot e -singlesnapshot argomenti della riga di comando. |
hardwarecounter | Descrive -pmcsources, -pmcsessions, -setprofint, -profint e -resetprofint argomenti della riga di comando. |
avanzato | Descrive gli argomenti -purgecache, -log, -disablepagingexecutive, -instancename e -container della riga di comando. |
SnapshotConfig
L'opzione SnapshotConfig abilita o disabilita la possibilità di acquisire snapshot occasionali o periodici dell'opzione>< snapshot\ per un processo o un processo specifico. Attualmente è possibile creare snapshot dell'heap.
Sintassi
wpr -SnapshotConfig <snapshot option> {-name <process name> | -pid <pid 1> [pid 2] ...} [{enable|disable}]
Se il {enable|disable}
parametro viene omesso, verrà visualizzata la configurazione dello snapshot corrente per il processo, ad esempio solo l'opzione -name .
Questo esempio usa il comando snapshotconfig con nomi di immagine:
wpr -snapshotconfig heap -name Win32Project1.exe //query snapshot config
wpr -snapshotconfig heap -name Win32Project1.exe enable //enable snapshot config
wpr -snapshotconfig heap -name Win32Project1.exe disable //disable snapshot config
Questo esempio usa il comando snapshotconfig con un PID:
wpr -snapshotconfig heap -pid 8048 enable //enable snapshot config
Nota
Se il processo e l'architettura del sistema operativo non corrispondono (ad esempio, un'app win32 in un sistema operativo a 64 bit), usare l'opzione nome immagine.
Nella tabella seguente vengono descritte le opzioni disponibili che è possibile applicare a questa opzione.
Switch | Descrizione |
---|---|
<opzione snapshot> | Specifica uno dei tipi di opzione snapshot. Attualmente è disponibile solo l'heap. |
-nome | Specifica il nome del processo. Questa opzione non può essere usata con l'opzione -Pid . Se questa opzione viene usata per abilitare lo snapshot, la configurazione verrà applicata a tutte le nuove istanze del nome del processo specificato. Assicurarsi di disabilitarlo al termine del test. |
-Pid | Specifica l'ID del processo. Questa opzione non può essere usata con l'opzione -name. Se questa opzione viene usata per abilitare lo snapshot, la configurazione verrà applicata immediatamente e per la durata del processo. |
SingleSnapshot
L'opzione SingleSnapshot attiva uno snapshot su richiesta dell'opzione snapshot per l'ID> processo <specificato.
Sintassi
wpr -SnapshotConfig <snapshot option> <pid 1> [pid 2] ... [up to pid 8]
Nota
La funzionalità snapshot deve essere abilitata per l'ID processo (o il nome) prima di chiamare SingleSnapshot.
Ad esempio: wpr -singlesnapshot heap <pid for foo.exe>
Per altre informazioni, vedere comando SnapshotConfig .
Nella tabella seguente vengono descritte le opzioni disponibili che è possibile applicare a questa opzione.
Switch | Descrizione |
---|---|
<opzione snapshot> | Specifica uno dei tipi di opzione snapshot. |
<pid> | Specifica l'ID del processo. |
EnablePeriodicSnapshot
L'opzione EnablePeriodicSnapshot attiva snapshot periodici a intervalli specificati e id processo specificati
Sintassi
wpr -enableperiodicsnapshot <snapshot option> <interval (in seconds)> <pid 1> [pid 2] ... [up to pid 8]
Nota
La funzionalità snapshot deve essere abilitata per l'ID processo (o il nome) prima di chiamare SingleSnapshot.
Ad esempio: wpr -enableperiodicsnapshot heap 60 <pid for foo.exe>
Per altre informazioni, vedere comando SnapshotConfig.
Nella tabella seguente vengono descritte le opzioni disponibili che è possibile applicare a questa opzione.
Switch | Descrizione |
---|---|
<opzione snapshot> | Specifica uno dei tipi di opzione snapshot. |
<interval> | Specifica l'intervallo in secondi. Si noti che l'intervallo minimo valido è 5. |
<pid> | Specifica l'ID del processo. |
DisablePeriodicSnapshot
L'opzione DisablePeriodicSnapshot disabilita gli snapshot periodici per tutti i processi specificati dall'opzione enableperiodicsnapshot .
Sintassi
wpr -disableperiodicsnapshot <snapshot option>
Esempio
wpr -disableperiodicsnapshot heap
Nella tabella seguente vengono descritte le opzioni disponibili che è possibile applicare a questa opzione.
Switch | Descrizione |
---|---|
<opzione snapshot> | Specifica uno dei tipi di opzione snapshot. |
PMCSources
L'opzione PMCSources esegue una query sull'elenco degli eventi PMU (Monitor prestazioni ing Unit) nel sistema e il relativo valore di intervallo predefinito per l'overflow del contatore. L'intervallo è il numero di eventi.
Sintassi
wpr -pmcsources
Nota
Monitor prestazioni Gli eventi unit vengono usati per misurare le prestazioni della CPU e comprendere il livello della CPU dei carichi di lavoro. In Windows HAL vengono implementati solo un subset di eventi PMU nei documenti di riferimento arm/intel. Di seguito è riportato l'output di esempio di questa opzione nel dispositivo CPU Intel:
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -pmcsources
Id Name Interval Min Max
--------------------------------------------------------------
0 Timer 10000 1221 1000000
2 TotalIssues 698400 4096 2147483647
6 BranchInstructions 65536 4096 2147483647
10 CacheMisses 65536 4096 2147483647
11 BranchMispredictions 65536 4096 2147483647
19 TotalCycles 65536 4096 2147483647
25 UnhaltedCoreCycles 65536 4096 2147483647
26 InstructionRetired 65536 4096 2147483647
27 UnhaltedReferenceCycles 65536 4096 2147483647
28 LLCReference 65536 4096 2147483647
29 LLCMisses 65536 4096 2147483647
30 BranchInstructionRetired 65536 4096 2147483647
31 BranchMispredictsRetired 65536 4096 2147483647
32 LbrInserts 65536 4096 2147483647
Sessioni PMCSessioni
Le opzioni PMCSessions eseguono query sull'elenco delle sessioni usando contatori hardware. Questa opzione è disponibile solo in Windows 11 o versione successiva.
Sintassi
wpr -pmcsessions
ProfInt
L'opzione ProfInt esegue una query sull'intervallo di "profilatura".
Sintassi
wpr -profint
Esempio
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -profint
Current Profile Interval = 10000 [1.0000ms]
SetProfInt
L'opzione SetProfInt imposta l'intervallo del profilo di campionamento per gli eventi PMU. Se il nome dell'evento PMU viene omesso, il valore predefinito è Timer.
Sintassi
wpr -setprofint [PMU event name] 1221...10000000
Esempio
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -setprofint 100000
New Profile Interval = 100000 [10.0000ms]
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -setprofint TotalIssues 1000000
New Profile Interval = 100000 [Counter: TotalIssues]
ResetProfInt
L'opzione ResetProfInt reimposta l'intervallo del profilo sul valore predefinito.
Sintassi
wpr -resetprofint [Profile Source Name]
Si noti che se [Nome origine profilo] non viene specificato, tutte le origini del profilo verranno reimpostate sul valore predefinito.
Nomeistanza
L'opzione Instancename specifica un nome per identificare in modo univoco l'istanza di traccia.
Questa opzione può essere applicata a tutti i comandi che modificano la sessione di registrazione e assegnano un nome di sessione di registrazione fornito dall'utente. WPR imposta il nome di sessione predefinito se questa opzione viene omessa.
Sintassi
wpr –{option <arguments>} -instancename <text>
Nota
-instancename deve essere l'ultimo parametro. Se le sessioni di registrazione sono state avviate con questa opzione, tutti i comandi successivi devono usare la stessa opzione instancename. Ad esempio:
C:\wpt>wpr -start cpu -instancename CpuSession
C:\wpt>wpr -status -instancename CpuSession
WPR recording is in progress...
...
Time since start : 00:00:05
Dropped event : 0
Logging mode : Memory
C:\wpt>wpr -stop cpu.etl -> omitting instancename option would not find CpuSession
There are no trace profiles running.
Error code: 0xc5583000
C:\wpt>wpr -stop cpu.etl -instancename CpuSession -> trace will be saved
Osservazioni:
Ogni volta che WPR salva una traccia acquisita durante l'esecuzione delle applicazioni gestite nel sistema, WPR salva i simboli gestiti accanto al file di traccia. Questa funzionalità consente l'analisi delle prestazioni delle applicazioni gestite.
La generazione di simboli gestiti è un'operazione di risorse e dispendiosa in termini di tempo. WPR crea automaticamente una cache dei simboli gestita per accelerare la generazione di simboli gestiti. Quando WPR necessita di simboli gestiti, controlla prima di tutto questa cache e usa i simboli disponibili e appropriati invece di rigenerarli.
Il percorso predefinito della cache dei simboli gestiti è C:\ProgramData\WindowsPerformanceRecorder\NGenPdbs_Cache.