Uso di Strumenti di traccia con VSS
Per raccogliere informazioni di traccia per l'infrastruttura VSS, è possibile usare lo strumento VssTrace, lo strumento Logman o lo strumento Tracelog. VssTrace è disponibile in Microsoft Windows Software Development Kit (SDK) e può essere usato per tracciare le applicazioni VSS in Windows 7 e versioni successive del sistema operativo Windows. Logman è un controller di traccia per gli eventi di traccia e i contatori delle prestazioni; può anche essere usato per tracciare le applicazioni VSS in Windows 7 e versioni successive del sistema operativo Windows. Tracelog è incluso in Windows Driver Kit (WDK).
Per usare gli strumenti di traccia con Ripristino automatico del sistema (ASR), vedere Uso di strumenti di traccia con applicazioni ASR.
Nota
VssTrace, Logman e Tracelog richiedono tutti privilegi di amministratore.
Per informazioni su ogni strumento, vedere le sezioni seguenti:
Uso di VssTrace
Per eseguire lo strumento VssTrace dalla riga di comando, usare la sintassi seguente:
vsstrace command-line-options
Per visualizzare la Guida della riga di comando concisa per lo strumento VssTrace, usare la sintassi seguente:
vsstrace -help
Per visualizzare la Guida dettagliata della riga di comando per lo strumento VssTrace, usare la sintassi seguente:
vsstrace -help all
Opzioni della riga di comando di VssTrace
Lo strumento VssTrace usa le opzioni della riga di comando seguenti:
-
-f Flag
-
Abilitare i moduli i cui flag sono specificati dalla maschera di bit Flags . Ogni flag corrisponde a un modulo VSS. Se Flags è zero, non sono abilitati moduli. Si noti che la maggior parte dei moduli è abilitata per impostazione predefinita. Questa opzione può essere combinata con l'opzione **+**Module . Ad esempio, vsstrace -f 0 +WRITER +COORD disabilita la traccia di tutti i moduli abilitati per impostazione predefinita e abilita la traccia dei writer VSS e del servizio VSS. In alternativa, vsstrace +f 0xffff -COORD abilita la traccia di tutti i moduli ad eccezione del servizio VSS.
Nota
Se si usa l'opzione -f insieme all'opzione **+**Module , l'opzione -f deve essere visualizzata prima dell'opzione **+**Module .
Nella tabella seguente sono elencati il nome e il flag del modulo per ogni modulo disponibile.
Modulo Flag Abilitata per impostazione predefinita Elementi tracciati EXCEPT 0x00000001 Sì Gestione delle eccezioni C++. COORD 0x00000002 Sì Il servizio VSS, detto anche coordinatore vss. SWPRV 0x00000004 Sì Servizio Del provider di copia shadow del sistema VSS. BUCOMP 0x00000008 Sì Il richiedente vss e l'elaborazione dei metadati di backup. WRITER 0x00000010 Sì Operazioni vss writer e implementazioni di writer ospitate vss, ad esempio il writer del Registro di sistema di Windows. VSSAPI 0x00000020 Sì Funzioni varie dell'API VSS esportate da VSSAPI.DLL. HWDIAG 0x00000040 Sì Infrastruttura e operazioni del provider hardware VSS. AMMIN 0x00000080 Sì Utilità della riga di comando di VSS, ad esempio VSSADMIN.EXE e DISKSHADOW.EXE. VSSUI 0x00000100 Sì L'interfaccia utente di configurazione copie shadow per cartelle condivise. L'interfaccia utente è disponibile solo nei sistemi operativi Windows Server. TEST 0x00000200 Sì Non applicabile. Questo modulo di traccia è riservato. IOCTL 0x00000400 Sì Dettagli delle operazioni FSCTL e IOCTL avviate dal servizio VSS chiamando la funzione DeviceIoControl. GEN 0x00000800 Sì Funzioni generali dell'utilità VSS, ad esempio allocatori, classi di stringhe e operazioni del Registro di sistema e dei volumi. WRXML 0x00001000 No Elaborazione XML per i metadati del writer. Questo modulo presenta un livello molto elevato di rumore. VSSXML 0x00002000 No Classi di base di elaborazione XML. Questo modulo presenta un livello molto elevato di rumore. -
**+**Modulo
-
Abilitare il modulo specificato da Module. È possibile abilitare più moduli alla volta. Per elencare i moduli disponibili, digitare vsstrace –help modules al prompt della riga di comando.
-
-Modulo
-
Disabilitare il modulo specificato da Module. Per elencare i moduli disponibili, digitare vsstrace –help modules al prompt della riga di comando.
-
+pid ProcessId
-
Abilitare il processo specificato da ProcessId. Per abilitare tutti i processi, usare "*" per il valore di ProcessId. È possibile specificare più opzioni pid alla volta. L'ordine delle opzioni determina quali processi sono abilitati o disabilitati. Ad esempio, per abilitare solo il processo il cui identificatore di processo è 0xe8c, usare vsstrace -pid * +pid 0xe8c.
-
-pid ProcessId
-
Disabilitare il processo specificato da ProcessId. Per disabilitare tutti i processi, usare "*" per il valore di ProcessId. È possibile specificare più opzioni pid alla volta. L'ordine delle opzioni determina quali processi sono abilitati o disabilitati. Ad esempio, per disabilitare tutti i processi ad eccezione del processo il cui identificatore di processo è 0xe8c, usare vsstrace -pid * +pid 0xe8c.
-
+tid ThreadId
-
Abilitare il thread specificato da ThreadId. Per abilitare tutti i thread, usare "*" per il valore di ThreadId. È possibile specificare più opzioni tid alla volta. L'ordine delle opzioni determina quali thread sono abilitati o disabilitati. Ad esempio, per abilitare solo il thread il cui identificatore di processo è 0x31a, usare vsstrace -tid * +tid 0x31a.
-
-tid ThreadId
-
Disabilitare il thread specificato da ThreadId. Per disabilitare tutti i thread, usare "*" per il valore di ThreadId. È possibile specificare più opzioni tid alla volta. L'ordine delle opzioni determina quali thread sono abilitati o disabilitati. Ad esempio, per disabilitare tutti i thread ad eccezione del thread il cui identificatore di processo è 0x31a, usare vsstrace -tid * +tid 0x31a.
-
-l Level
-
Usare il livello di traccia specificato da Level. Maggiore è il livello, più dettagliato è l'output di traccia. Ogni livello include tutti i livelli inferiori. Il livello predefinito è 170. Sono disponibili i livelli seguenti.
Livello Informazioni incluse nell'output di traccia 000 None 020 Errori irreversibili 030 Eccezioni non gestite 040 Errori 050 Asserzioni 060 Avvisi 080 Gestione delle eccezioni 100 Attività del registro eventi 120 Informazioni generali 140 flusso del codice 160 Immettere e uscire dalla funzione 170 Valori restituiti dalle funzioni 180 Parametri della funzione (terse) 190 Parametri della funzione (dettagliato) 200 Livello di informazioni dettagliato 1 210 Livello di informazioni dettagliato 2 220 Livello di informazioni dettagliato 3 230 Livello di codice rapido 1 240 Livello di codice rapido 2 250 Livello di codice rapido 3 255 Tutte le date -
+rientro
-
Rientro dell'output di traccia formattato in corrispondenza di ogni funzione e limite di sottofunzione.
-
-rientrare
-
Non applicare un rientro all'output di traccia formattato.
-
-etl EtlFile
-
Convertire il file di output logman specificato da EtlFile in un formato di testo leggibile.
-
-o OutputFile
-
Salvare le informazioni di traccia nel file di output specificato da OutputFile. Per ottenere prestazioni ottimali, il file di output deve trovarsi in un volume che non fa parte della copia shadow.
-
-helpOption
-
Visualizzare la Guida della riga di comando come specificato da HelpOption. I valori validi di HelpOption sono moduli, livelli e tutti. Se si specificano moduli, i moduli verranno elencati. Se si specificano livelli, i livelli disponibili verranno elencati. Specificando tutte le cause della visualizzazione della Guida dettagliata. Se non vengono usate opzioni, viene visualizzata la Guida concisa.
Uso di Logman
La procedura seguente descrive come usare Logman con l'applicazione VSS.
Per usare Logman con l'applicazione VSS
Usare il comando seguente per avviare la traccia:
logman start vss -o *x:\*vss.etl -ets -p {9138500e-3648-4edb-aa4c-859e9e9f7b7c38} 0xfff 170
Nota
Sostituire "x:\" con il percorso della directory in cui si desidera archiviare il file di log di traccia.
Usare il comando seguente per arrestare la traccia:
logman stop vss -ets
Il file di log di traccia è *x:\*vss.etl.
Per altre informazioni sullo strumento Logman, vedere Logman.
Uso di Tracelog
La procedura seguente descrive come usare Tracelog.
Per usare Tracelog
Creare un file di testo denominato vss.ctl contenente solo il testo seguente:
9138500e-3648-4edb-aa4c-859e9f7b7c38 vss
Usare il comando seguente per avviare la traccia:
tracelog -start vss -f *x:\*vss.etl -guid vss.ctl -flag 0xff -level 0xaa
Nota
Sostituire "x:\" con il percorso della directory in cui si desidera archiviare il file di log di traccia.
Usare il comando seguente per arrestare la traccia:
tracelog -stop vss
Il file di log di traccia è *x:\*vss.etl.
Per altre informazioni sullo strumento Tracelog, vedere Tracelog.