Condividi tramite


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: 

Profile : CPU.Verbose.Memory

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: 

Nome agente di raccolta: NT Kernel Logger Buffer Size (KB) : 1024 eventi persi: 0 Parole chiave di sistema CSwitch ProcessThread SampledProfile System Stacks CSwitch SampledProfile

Collector Name : WPR_initiated_WPR Event Collector Buffer Size (KB) : 1024 Events Lost : 0 Providers Microsoft-Windows-Shell-Core: 0x1000000000000: 0x04 Microsoft-Windows-Win32k: 0x1000000402000: 0xff : Stack CaptureState Providers on Save Microsoft-Windows-Win32k: 0x80000: 0xff

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

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.

Informazioni di riferimento su WPR