Condividi tramite

Uso di Strumenti di Tracciamento con VSS

  • Articolo

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:

vsstraceopzioni-della-riga-di-comando

Per visualizzare la guida concisa alla riga di comando per lo strumento VssTrace, usare la seguente sintassi:

vsstrace -help

Per visualizzare l'aiuto dettagliato dei comandi 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:

-fFlags

Abilitare i moduli i cui flag sono specificati dalla bitmask 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 Bandiera Abilitata per impostazione predefinita Elementi tracciati
ECCETTO 0x00000001 Sì Gestione delle eccezioni C++.
COORD 0x00000002 Sì Il servizio VSS, detto anche il coordinatore VSS.
SWPRV 0x00000004 Sì Servizio del provider di copia ombra del sistema VSS.
BUCOMP 0x00000008 Sì Richiedente VSS e elaborazione dei metadati di backup.
SCRITTORE 0x00000010 Sì Operazioni dei Writer VSS e implementazioni dei Writer ospitati VSS, come 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.
Amministratore 0x00000080 Sì Utilità della riga di comando di VSS, ad esempio VSSADMIN.EXE e DISKSHADOW.EXE.
VSSUI 0x00000100 Sì L'interfaccia utente per la configurazione delle Copie Shadow per le cartelle condivise. L'interfaccia utente è disponibile solo nei sistemi operativi Windows Server.
TEST 0x00000200 Sì Non applicabile. Questo modulo di tracciamento è 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 dello scrittore. 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.

+pidProcessId

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.

-pidProcessId

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.

+tidThreadId

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.

-tidThreadId

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.

-lLevel

Usare il livello di traccia specificato da Level. Maggiore è il livello, più verboso è l'output di registrazione. 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 (concisi)
190 Parametri della funzione (dettagliato)
200 Livello di informazioni dettagliate 1
210 Livello di informazioni dettagliato 2
220 Livello 3 di informazioni verbose
230 Livello di codice rapido 1
240 Livello di codice rapido 2
250 Livello di codice rapido 3
255 Tutti

 

+rientro

Indenta l'output di traccia formattato al confine di ogni funzione e sottofunzione.

-rientrare

Non applicare un rientro all'output di traccia formattato.

-etlEtlFile

Convertire il file di output logman specificato da EtlFile in un formato di testo leggibile.

-oOutputFile

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

Visualizza la documentazione 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 tutto fa sì che venga visualizzato l'aiuto dettagliato. Se non vengono usate opzioni, viene visualizzato l'aiuto conciso.

Uso di Logman

La procedura seguente descrive come usare Logman con l'applicazione VSS.

Per usare Logman con l'applicazione VSS

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

     

  2. Usare il comando seguente per interrompere la registrazione:

    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

  1. Creare un file di testo denominato vss.ctl contenente solo il testo seguente:

    9138500e-3648-4edb-aa4c-859e9f7b7c38 vss

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

     

  3. Usare il comando seguente per arrestare il monitoraggio:

    tracelog -stop vss

Il file di log di traccia è *x:\*vss.etl.

Per altre informazioni sullo strumento Tracelog, vedere Tracelog.