Avvio
Visualizza le opzioni di avvio del logger.
xperf [-start [LoggerName] [ProfileFileName!ProfileName|SessionName]|-update [LoggerName]|[ProfileFileName!ProfileName|SessionName]] -flush [LoggerName] -save ProfileFileName!ProfileName|SessionName merged.etl -setprofint [<n>] [cached] -seteresourcesample <n1> <n2> <n3> -setspinlocksample <n1> <n2> <n3> -pooltag <P1>+<P2>+<P3>+<P4> -on (GUID|KnownProviderName)[:Flags[:Level[<:0xnnnnnnnn|’stack|[,]sid[,]tsid’]]]
Parametri
| Comando | Descrizione |
|---|---|
-start [LoggerName]|[ ProfileFileName! ProfileName |SessionName]] |
Avvia una sessione di registrazione per LoggerName, avvia i logger nel profilo ProfileName definito nel file ProfileFileName o avvia logger SessionName definito nel file ProfileFileName. |
-update [LoggerName]|[ ProfileFileName! ProfileName |SessionName]] |
Aggiorna una sessione di registrazione per LoggerName, aggiorna i logger nel profilo ProfileName definito nel file ProfileFileName o aggiorna il logger SessionName definito nel file ProfileFileName. |
-flush LoggerName |
Scarica una sessione di registrazione per LoggerName. Questo parametro è necessario per salvare una traccia in modalità buffer (vedere il parametro -buffering , di seguito). Per salvare una traccia in modalità buffer, è necessario rilasciare il parametro -flush . |
-capturestate LoggerName Flags |
Acquisisce lo stato nella sessione di registrazione non kernel dai provider specificati in Flag. Il formato del provider accettato è uguale a per -on. Se vengono specificati flag e livello, vengono abilitati durante l'acquisizione dello stato. Viene chiamato per la traccia avviata con l'opzione –buffering . Deve essere seguito da –stop per arrestare la traccia. |
-on Flags|Gruppi |
Per le sessioni di registrazione del kernel, la sequenza di flag e gruppi del kernel da abilitare, separati da segni più (+). Per le sessioni di registrazione utente, la sequenza di provider da abilitare, separata dai segni più (+). Il formato del provider accettato è |
-f filename |
Registra gli eventi nel file specificato. Il valore predefinito è \Kernel.etl per le tracce del kernel e \User.etl per le tracce utente. |
-buffersize Size |
Imposta le dimensioni del buffer di traccia su Dimensioni, in KB. I valori possibili sono compresi tra 4 e 1024. Il valore predefinito è 64. |
-minbuffers n |
Imposta il numero minimo di buffer di traccia su n. Il valore predefinito è 64. |
-maxbuffers n |
Imposta il numero massimo di buffer di traccia su n. Il valore predefinito è 320. |
-maxfile Size |
Imposta le dimensioni massime del file su Dimensioni MB. |
-flushtimer n |
Imposta il timer di scaricamento su n secondi. |
-boottrace Flags|Gruppi|off |
Configura il logger Event Tracing for Windows per tracciare l'avvio. Impostare flag su "off" per disattivare la traccia di avvio. Tutti i controlli di registrazione possono essere usati insieme a questo. Usare in combinazione con -f per accedere a un file diverso da \Perf.etl. |
-realtime |
Abilita la traccia in tempo reale. |
-Buffer |
Abilita la traccia in modalità buffering. Per salvare, usare -flush. L'opzione -stop non salva la traccia. |
-filemode Mode |
Imposta la modalità file. Il valore predefinito è "Sequenziale". Possibili modalità: "Sequenziale", "Circolare", "Append" e "NewFile". |
-clocktype ClockType |
Imposta il tipo di orologio. Il valore predefinito è "PerfCounter". Tipi possibili: "Cycle", "PerfCounter" e "SystemTime". |
-stackwalk flags|@file |
Abilita l'analisi dello stack per gli eventi specificati come |
-pids pid [...] |
Applica i flag ai processi Quando si specificano più pid, separarli con uno spazio, come in |
Riga di comando -pidnewprocess <> |
Applica i flag a un nuovo processo che Xperf inizierà con <la riga> di comando. Usato in combinazione con logger privati. |
-waitfornewprocess |
Attende un nuovo processo creato usando |
-mucchio |
Abilita la traccia dell'heap nei processi specificati da Pids e PidNewProcess. |
-critsec |
Abilita la traccia di sezioni critiche nei processi specificati da Pids e PidNewProcess. |
-setprofint [<n>] [cached] |
Imposta l'intervallo del profilo campionato su |
-save ProfileFileName! ProfileName |SessionName merged.etl |
Scarica i logger nel profilo ProfileName definito nel file ProfileFileName e unisce i file ETL a merged.etl oppure scarica sessionName del logger definito nel file ProfileFileName e unisce il file ETL a Merged.etl. |
-seteresourcesample <n1><n2><n3> |
Imposta il campionamento ERESOURCE, dove n1 la frequenza di campionamento delle versioni è maggiore o uguale a 1000, la frequenza di campionamento delle contese n2 è maggiore o uguale a 1 e n3 numero di timeout eccessivi è maggiore o uguale a 1. La frequenza dei campioni di contesa è la frequenza con cui vengono acquisiti eventi di spinlock quando si verificano conflitti. Ad esempio, se questo valore è 100, viene acquisito un evento spinlock per ogni cento collisioni spin lock. |
-setspinlocksample <n1><n2><n3> |
Imposta la soglia di spinlock su |
-pooltag< P1>+<P2>+<P3>+<P4> |
Imposta i filtri tag del pool (Pn) separati da segni più (+) o punto e virgola (;). Usare un punto interrogativo (?) per un carattere jolly a carattere singolo o un asterisco (*) per un carattere jolly multiplo. È possibile specificare un massimo di quattro filtri. |
Osservazioni:
È possibile avviare più logger usando più opzioni di avvio, ognuna seguita dalle opzioni da applicare a tale logger. Se LoggerName o -start LoggerName viene omesso, il logger del kernel è implicito. Solo una singola istanza del logger del kernel può esistere in qualsiasi momento. Se uno dei logger non viene avviato, tutti i logger già avviati vengono arrestati.