Comandi del controllo TraceView
Nota
Le opzioni della riga di comando TraceView sono deprecate. Usare tracepdb.exe e tracefmt.exe per analizzare i PDB in file TMF e analizzare i file con estensione etl rispettivamente in testo.content
Usare un comando di controllo Traceview per gestire le sessioni di traccia, inclusi l'avvio e l'arresto della sessione, l'abilitazione e la disabilitazione dei provider, l'aggiornamento delle proprietà della sessione di traccia e lo scaricamento dei buffer di traccia.
traceview {-start | -stop | -update | -enable | -disable | -flush | -q} SessionName [Parameters]
traceview {-enumguid | -l | -h | -x}
Parametri dei comandi
Azioni
| Azione | Descrizione |
|---|---|
| -inizio | Avvia la sessione di traccia specificata. |
| -fermarsi | Arresta la sessione di traccia specificata. |
| -aggiornare | Aggiorna le proprietà per la sessione di traccia specificata. |
| -abilitare | Abilita i provider per la sessione di traccia specificata. |
| -disabilitare | Disabilita i provider per la sessione specificata. |
| -sciacquone | Scarica i buffer attivi della sessione di traccia specificata. Questo scaricamento forzato è oltre agli scaricamenti automatici che si verificano quando un buffer è pieno e quando la sessione di traccia si arresta. |
| -q | Eseguire una query sullo stato della sessione di traccia specificata. |
| -enumguid | Elenca i provider nel sistema registrati con Event Tracing for Windows (ETW). |
| -l | Elencare tutte le sessioni di traccia in esecuzione nel computer. |
| -x | Arresta tutte le sessioni di traccia. |
Parametri
SessionName
Se usato con -start, SessionName è un nome selezionato per rappresentare la sessione di traccia. Con tutti gli altri comandi, SessionName identifica la sessione di traccia.
-f [LogFile]
Se usato con -start, -f avvia una sessione del log di traccia. LogFile specifica il percorso (facoltativo) e il nome file del file del log di traccia eventi (con estensione etl). Il valore predefinito è C:\LogFile.etl.
Se usato con -update, -f invia tutti i nuovi messaggi di traccia solo al log di traccia specificato. Usare questo parametro per convertire una sessione di traccia in tempo reale in una sessione del log di traccia o per avviare un nuovo log di traccia per una sessione del log di traccia esistente. Per inviare messaggi di traccia a un consumer di traccia in tempo reale e a un log di traccia, usare entrambi i parametri -rt e -f nel comando -update .
-Rt
Se usato con -start, -rt avvia sessioni di traccia in tempo reale (una sessione del log di traccia (-f) è l'impostazione predefinita. Se si usa -rt e -f in un comando -start , i messaggi di traccia vengono inviati al consumer di traccia e a un file di log di traccia eventi.
Se usato con -update, -rt aggiunge il recapito dei messaggi in tempo reale a una sessione del log di traccia. Tutti i nuovi messaggi di traccia vengono inviati direttamente al consumer di traccia (come in una sessione di traccia in tempo reale), oltre a un log di traccia.
-guid {#GUID GUIDFile | }
Specifica uno o più provider di traccia. Usare con -start per abilitare i provider per una sessione di traccia. Usare con -enable per abilitare i provider o modificare i valori -flag o -level . Usare con -disable per specificare i provider da disabilitare.
IL GUID può specificare un GUID di controllo (preceduto da un segno di numero (#)) o il percorso (facoltativo) e il nome file di un file di testo, ad esempio un file GUID (con estensione ctl), che contiene i GUID di controllo di uno o più provider di traccia.
Se si omette il parametro -guid da un comando -start , TraceView avvia una sessione di traccia NT Kernel Logger.
TraceView passa i valori dei sottoparametri seguenti ai provider specificati.
| Parametro | Descrizione |
|---|---|
| SessionName | Se usato con -start, SessionName è un nome selezionato per rappresentare la sessione di traccia. Con tutti gli altri comandi, SessionName identifica la sessione di traccia. |
| -f \[LogFile\] | Se usato con -start, -f avvia una sessione del log di traccia. LogFile specifica il percorso (facoltativo) e il nome file del file del log di traccia eventi (con estensione etl). Il valore predefinito è C:\\LogFile.etl. Se usato con -update, -f invia tutti i nuovi messaggi di traccia solo al [log di traccia](trace-log.md). Usare questo parametro per convertire una sessione di traccia in tempo reale in una sessione del log di traccia o per avviare un nuovo log di traccia per una sessione del log di traccia esistente. Per inviare messaggi di traccia a un consumer di traccia in tempo reale e a un log di traccia, usare entrambi i parametri -rt e -f nel comando -update . |
| -Rt | Se usato con -start, -rt avvia sessioni di traccia in tempo reale (una sessione del log di traccia (-f) è l'impostazione predefinita. Se si usa -rt e -f in un comando -start , i messaggi di traccia vengono inviati al consumer di traccia e a un file di log di traccia eventi. Se usato con -update, -rt aggiunge il recapito dei messaggi in tempo reale a una sessione del log di traccia. Tutti i nuovi messaggi di traccia vengono inviati direttamente al consumer di traccia (come in una sessione di traccia in tempo reale), oltre a un [log di traccia](trace-log.md). |
| -guid {\#GUID GUIDFile | } | Specifica uno o più provider di traccia. Usare con -start per abilitare i provider per una sessione di traccia. Usare con -enable per abilitare i provider o modificare i valori -flag o -level . Usare con -disable per specificare i provider da disabilitare. IL GUID può specificare un [GUID di controllo](control-guid.md) (preceduto da un segno di numero (\#)) o il percorso (facoltativo) e il nome file di un file di testo, ad esempio un file GUID di controllo (con estensione ctl), che contiene i GUID del controllo di uno o più provider di traccia. Se si omette il parametro -guid da un comando -start , TraceView avvia una [sessione di traccia del logger kernel NT](nt-kernel-logger-trace-session.md). |
TraceView passa i valori dei sottoparametri seguenti al provider specificato:
-b BufferSize
Specifica le dimensioni, in KB, di ogni buffer allocato per la sessione di traccia. Usare solo con -start.
Il valore predefinito è determinato dal numero di processori, dalla quantità di memoria fisica e dal sistema operativo in uso.
-Min NumberOfBuffers
Specifica il numero di buffer inizialmente allocati per l'archiviazione dei messaggi di traccia. Usare solo con -start.
Il valore predefinito è determinato dal numero di processori, dalla quantità di memoria fisica e dal sistema operativo in uso.
-Max NumberOfBuffers
Se usato con -start, -max specifica il numero massimo di buffer allocati per la sessione di traccia. Il valore predefinito è determinato dal numero di processori, dalla quantità di memoria fisica e dal sistema operativo in uso.
Se usato con -update, -max modifica il numero massimo di buffer allocati per la sessione di traccia.
-Ft FlushTime
Se usato con -start, -ft specifica la frequenza, in secondi, dei buffer dei messaggi di traccia scaricati. Se usato con -update, -ft modifica il tempo di scaricamento nell'ora specificata.
Il tempo minimo di scaricamento è 1 secondo. Il valore predefinito è 0 (nessuna scaricamento forzato).
Questo scaricamento forzato si aggiunge agli scaricamenti che vengono eseguiti automaticamente ogni volta che un buffer di messaggi di traccia è pieno e quando una sessione di traccia si arresta.
Vedere anche: -flush.
-Paging
Usa la memoria di paging per i buffer dei messaggi di traccia. Per impostazione predefinita, la traccia eventi usa memoria non di paging per i buffer. Usare solo con -start.
Non usare questo parametro quando il provider è un driver che potrebbe generare messaggi di traccia in un irQL maggiore di DISPATCH_LEVEL.
Questo parametro non è supportato in Windows 2000.
-Seq MaxFileSize
Specifica la registrazione sequenziale (alla fine del file, arresta la registrazione degli eventi) nel file del log di traccia eventi (con estensione etl). Usare solo con -start.
MaxFileSize specifica le dimensioni massime del file in MB. Senza un valore MaxFileSize , questo parametro viene ignorato.
La registrazione sequenziale è l'impostazione predefinita, ma è possibile usare questo parametro per impostare le dimensioni massime del file o per usare -prealloc. Senza questo parametro, non esiste alcun limite di dimensioni del file.
-Cir MaxFileSize
Specifica la registrazione circolare (alla fine del file, registrare nuovi messaggi sui messaggi meno recenti) nel file del log di traccia eventi (con estensione etl). Usare solo con -start.
MaxFileSize specifica le dimensioni massime del file in MB. Senza un valore MaxFileSize , questo parametro viene ignorato.
Il valore predefinito è la registrazione sequenziale senza limiti di dimensioni del file.
-prealloc
Riserva spazio per il file del log di traccia eventi (con estensione etl) prima di allocarlo. Usare solo con -start.
Questo parametro richiede -seq o -cir con MaxFileSize. Non è valido con -newfile.
Flag rappresenta un valore di flag definito nel provider di traccia, in formato decimale o esadecimale. Il valore predefinito è 0. I valori da 0x01000000 a 0xFF000000 sono riservati per uso futuro.
Il significato dei flag è definito in modo indipendente da ogni provider di traccia. In genere, i flag rappresentano livelli di report sempre più dettagliati.
In un comando -start il valore dei flag si applica a tutti i provider di traccia nella sessione di traccia. Per impostare flag diversi per ogni provider di traccia, usare un comando -enable separato per ogni provider di traccia.
| Sottoparametri di -guid | Descrizione |
|---|---|
-flag Flag |
|
|
Livello di livello |
Specifica il livello di traccia per i provider nella sessione di traccia. Il livello determina gli eventi generati dal provider di traccia. Level rappresenta un valore di livello in formato decimale o esadecimale. Il valore predefinito è 0. Il significato del valore del livello viene definito in modo indipendente da ogni provider di traccia. In genere, il livello di traccia rappresenta la gravità dell'evento (informazioni, avviso o errore). In un comando -start il valore di livello si applica a tutti i provider di traccia nella sessione di traccia. Per impostare livelli diversi per ogni provider di traccia, usare un comando -enable separato per ogni provider di traccia. |
| -b BufferSize | Specifica le dimensioni, in KB, di ogni buffer allocato per la sessione di traccia. Usare solo con -start.
Il valore predefinito è determinato dal numero di processori, dalla quantità di memoria fisica e dal sistema operativo in uso. |
| -min NumberOfBuffers | Specifica il numero di buffer inizialmente allocati per l'archiviazione dei messaggi di traccia. Usare solo con -start.
Il valore predefinito è determinato dal numero di processori, dalla quantità di memoria fisica e dal sistema operativo in uso. |
| -max NumberOfBuffers | Se usato con -start, -max specifica il numero massimo di buffer allocati per la sessione di traccia. Il valore predefinito è determinato dal numero di processori, dalla quantità di memoria fisica e dal sistema operativo in uso.
Se usato con -update, -max modifica il numero massimo di buffer allocati per la sessione di traccia. |
| -ft FlushTime | Se usato con -start, -ft specifica la frequenza, in secondi, dei buffer dei messaggi di traccia scaricati. Se usato con -update, -ft modifica il tempo di scaricamento nell'ora specificata.
Il tempo minimo di scaricamento è 1 secondo. Il valore predefinito è 0 (nessuna scaricamento forzato). Questo scaricamento forzato si aggiunge agli scaricamenti che vengono eseguiti automaticamente ogni volta che un buffer di messaggi di traccia è pieno e quando una sessione di traccia si arresta. Vedere anche: -flush. |
| -age AgeLimit | Se usato con -start, -age specifica per quanto tempo (in minuti) i buffer di traccia inutilizzati vengono mantenuti prima che vengano liberati. Se usato con -update, -age modifica il limite di validità al valore specificato.
Limite di validità specifica per quanto tempo (in minuti) i buffer di traccia inutilizzati vengono mantenuti prima che vengano liberati. L'impostazione predefinita è 15 minuti. Questo parametro è valido solo in Windows 2000. |
| -Paging | Usa la memoria di paging per i buffer dei messaggi di traccia. Per impostazione predefinita, la traccia eventi usa memoria non di paging per i buffer. Usare solo con -start.
Non usare questo parametro quando il provider è un driver che potrebbe generare messaggi di traccia in un IRQL maggiore di DISPATCH\_LEVEL. Questo parametro non è supportato in Windows 2000. |
| -seq MaxFileSize | Specifica la registrazione sequenziale (alla fine del file, arresta la registrazione degli eventi) nel file del log di traccia eventi (con estensione etl). Usare solo con -start.
MaxFileSize specifica le dimensioni massime del file in MB. Senza un valore MaxFileSize , questo parametro viene ignorato. La registrazione sequenziale è l'impostazione predefinita, ma è possibile usare questo parametro per impostare le dimensioni massime del file o per usare -prealloc. Senza questo parametro, non esiste alcun limite di dimensioni del file. |
| -cir MaxFileSize | Specifica la registrazione circolare (alla fine del file, registrare nuovi messaggi sui messaggi meno recenti) nel file del log di traccia eventi (con estensione etl). Usare solo con -start.
MaxFileSize specifica le dimensioni massime del file in MB. Senza un valore MaxFileSize , questo parametro viene ignorato. Il valore predefinito è la registrazione sequenziale senza limiti di dimensioni del file. |
| -prealloc | Riserva spazio per il file del log di traccia eventi (con estensione etl) prima di allocarlo. Usare solo con -start.
Questo parametro richiede -seq o -cir con MaxFileSize. Non è valido con -newfile. Il sistema crea il file del log di traccia eventi (con estensione etl) con una dimensione uguale al valore MaxFileSize specificato usando i parametri -seq o -cir . Quando si arresta la sessione, il file di log viene ridotto alle dimensioni del contenuto. |
| -newfile MaxFileSize | Crea un nuovo file di log di traccia eventi (con estensione etl) ogni volta che il file esistente raggiunge MaxFileSize. Usare solo con -start.
MaxFileSize specifica le dimensioni massime di ogni file di log in MB. Senza un valore MaxFileSize , questo parametro viene ignorato. Quando si usa -newfile, è necessario usare anche il parametro -f LogFile e il valore di LogFile deve essere un nome che include i caratteri %d indica un criterio decimale, ad esempio trace%d.etl. In caso contrario, il comando ha esito negativo con ERROR\_INVALID\_NAME. Windows incrementa il valore decimale nel nome del file ogni volta che crea un nuovo file. Questo parametro non è valido con la preallocazione (-prealloc logging (-cir), con la sessione NT Kernel Logger o per le sessioni di traccia privata. Non è supportato in Windows 2000. |
| -aggiungere | Accoda i messaggi di traccia a un file di log di traccia eventi (con estensione etl) esistente. L'impostazione predefinita consiste nel creare un nuovo file. Usare solo con -start.
Questo parametro è valido solo nei file sequenziali e solo quando si usa -f e -rt non viene usato. Non è supportato in Windows 2000. |
| -Kd | Reindirizza i messaggi di traccia a KD o Windbg, a qualsiasi elemento collegato. Questo parametro imposta anche le dimensioni del buffer di traccia su 3 KB, le dimensioni massime del buffer per il debugger e ignora tutti i parametri -b nel comando. Usare solo con -start. |
Commenti
Un comando traceview senza parametri apre la finestra TraceView.
È possibile usare il comando TraceView -start per avviare una sessione di traccia globale del logger. A tale scopo, usare il formato di comando seguente. A differenza di altri comandi, la parola "GlobalLogger" in questo formato di comando fa distinzione tra maiuscole e minuscole.
traceview -start GlobalLogger [parameters]