Partager via

Utilisation des outils de traçage avec VSS

  • Article

Pour collecter des informations de traçage pour l’infrastructure VSS, vous pouvez utiliser l’outil VssTrace, l’outil Logman ou l’outil Tracelog. VssTrace est disponible dans le Microsoft Windows Software Development Kit (SDK) et peut être utilisé pour tracer les applications VSS sur Windows 7 et versions ultérieures du système d’exploitation Windows. Logman est un contrôleur de traçage pour les événements de traçage et les compteurs de performance ; il peut également être utilisé pour tracer les applications VSS sur Windows 7 et versions ultérieures du système d’exploitation Windows. Tracelog est inclus dans le Windows Driver Kit (WDK).

Pour utiliser les outils de traçage avec Automated System Recovery (ASR), veuillez consulter la section Utilisation des outils de traçage avec les applications ASR.

Remarque

VssTrace, Logman et Tracelog nécessitent tous des privilèges d’administrateur.

 

Pour plus d’informations sur chaque outil, consultez les sections suivantes :

Utilisation de VssTrace

Pour exécuter l’outil VssTrace depuis la ligne de commande, utilisez la syntaxe suivante :

vsstrace command-line-options

Pour afficher une aide concise en ligne de commande pour l’outil VssTrace, utilisez la syntaxe suivante :

vsstrace -help

Pour afficher une aide détaillée en ligne de commande pour l’outil VssTrace, utilisez la syntaxe suivante :

vsstrace -help all

Options en ligne de commande de VssTrace

L’outil VssTrace utilise les options en ligne de commande suivantes :

-f Flags

Activez les modules dont les indicateurs sont spécifiés par le masque de bits Flags. Chaque indicateur correspond à un module VSS. Si Flags est zéro, aucun module n’est activé. Notez que la plupart des modules sont activés par défaut. Cette option peut être combinée avec l’option **+**Module. Par exemple, vsstrace -f 0 +WRITER +COORD désactive le traçage de tous les modules activés par défaut et active le traçage des writers VSS et du service VSS. Alternativement, vsstrace +f 0xffff -COORD active le traçage de tous les modules sauf le service VSS.

Remarque

Si vous utilisez l’option -f avec l’option **+**Module, le -f doit apparaître avant l’option **+**Module.

 

Le tableau suivant répertorie le nom du module et l’indicateur pour chaque module disponible.

Module Indicateur Activé par défaut Éléments tracés
EXCEPT 0x00000001 Oui Gestion des exceptions C++.
COORD 0x00000002 Oui Le service VSS, également appelé le coordonnateur VSS.
SWPRV 0x00000004 Oui Le service fournisseur de capture instantanée système VSS.
BUCOMP 0x00000008 Oui Le requérant VSS et le traitement des métadonnées de sauvegarde.
WRITER 0x00000010 Oui Les opérations des writers VSS et les implémentations de writers hébergés par VSS, tels que le writer du registre Windows.
VSSAPI 0x00000020 Oui Fonctions diverses de l’API VSS exportées par VSSAPI.DLL.
HWDIAG 0x00000040 Oui Infrastructure et opérations des fournisseurs de matériel VSS.
ADMIN 0x00000080 Oui Utilitaires en ligne de commande VSS tels que VSSADMIN.EXE et DISKSHADOW.EXE.
VSSUI 0x00000100 Oui L’interface utilisateur (UI) de configuration des copies de sauvegarde pour les dossiers partagés. L’UI n’est disponible que sur les systèmes d’exploitation Windows Server.
TEST 0x00000200 Oui Non applicable. (Ce module de traçage est réservé.)
IOCTL 0x00000400 Oui Détails des opérations FSCTL et IOCTL que le service VSS a initiées en appelant la fonction DeviceIoControl.
GEN 0x00000800 Oui Fonctions utilitaires générales VSS, telles que les allocateurs, les classes de chaînes, et les opérations de registre et de volume.
WRXML 0x00001000 Non Traitement XML pour les métadonnées des writers. Ce module a un niveau de bruit très élevé.
VSSXML 0x00002000 Non Classes de base du traitement XML. Ce module a un niveau de bruit très élevé.

 

**+**Module

Activez le module spécifié par Module. Plus d’un module peut être activé en même temps. Pour lister les modules disponibles, tapez vsstrace –help modules à l’invite de commande.

-Module

Désactivez le module spécifié par Module. Pour lister les modules disponibles, tapez vsstrace –help modules à l’invite de commande.

+pid ProcessId

Activez le processus spécifié par ProcessId. Pour activer tous les processus, utilisez « * » pour la valeur de ProcessId. Plus d’une option pid peut être spécifiée en même temps. L’ordre des options détermine quels processus sont activés ou désactivés. Par exemple, pour activer uniquement le processus dont l’identifiant est 0xe8c, utilisez vsstrace -pid * +pid 0xe8c.

-pid ProcessId

Désactivez le processus spécifié par ProcessId. Pour désactiver tous les processus, utilisez « * » pour la valeur de ProcessId. Plus d’une option pid peut être spécifiée en même temps. L’ordre des options détermine quels processus sont activés ou désactivés. Par exemple, pour désactiver tous les processus sauf le processus dont l’identifiant est 0xe8c, utilisez vsstrace -pid * +pid 0xe8c.

+tid ThreadId

Activez le thread spécifié par ThreadId. Pour activer tous les threads, utilisez « * » pour la valeur de ThreadId. Plus d’une option tid peut être spécifiée en même temps. L’ordre des options détermine quels threads sont activés ou désactivés. Par exemple, pour activer uniquement le thread dont l’identifiant de processus est 0x31a, utilisez vsstrace -tid * +tid 0x31a.

-tid ThreadId

Désactivez le thread spécifié par ThreadId. Pour désactiver tous les threads, utilisez « * » pour la valeur de ThreadId. Plus d’une option tid peut être spécifiée en même temps. L’ordre des options détermine quels threads sont activés ou désactivés. Par exemple, pour désactiver tous les threads sauf le thread dont l’identifiant de processus est 0x31a, utilisez vsstrace -tid * +tid 0x31a.

-l Level

Utilisez le niveau de traçage spécifié par Level. Plus le niveau est élevé, plus la sortie de trace est verbeuse. Chaque niveau inclut tous les niveaux inférieurs. Le niveau par défaut est 170. Les niveaux suivants sont disponibles.

Niveau Informations incluses dans la sortie de trace
000 Aucun(e)
020 Erreurs irrécupérables
030 Exceptions non prises en charge
040 Erreurs
050 Assertions
060 Avertissements
080 Traitement des exceptions
100 Activité du journal des événements
120 Informations générales
140 Flux de code
160 Entrée et sortie de fonction
170 Valeurs de retour d’une fonction
180 Paramètres de fonction (concise)
190 Paramètres de fonction (verbeuse)
200 Niveau d’information verbeuse 1
210 Niveau d’information verbeuse 2
220 Niveau d’information verbeuse 3
230 Niveau de code rapide 1
240 Niveau de code rapide 2
250 Niveau de code rapide 3
255 Tous

 

+indent

Mettre en retrait la sortie de trace formatée à chaque fonction et sous-fonction.

-indent

Ne mettez pas en retrait la sortie de trace mise en forme.

-etl EtlFile

Convertissez le fichier de sortie Logman spécifié par EtlFile en un format texte lisible.

-o OutputFile

Enregistrez les informations de traçage dans le fichier de sortie spécifié par OutputFile. Pour de meilleures performances, le fichier de sortie doit être situé sur un volume qui ne fait pas partie de la capture instantanée.

-help HelpOption

Affichez l’aide en ligne de commande spécifiée par HelpOption. Les valeurs valides de HelpOption sont modules, levels et all. La spécification de modules fait lister les modules. La spécification de levels fait lister les niveaux disponibles. La spécification de all fait afficher l’aide détaillée. Si aucune option n’est utilisée, une aide concise est affichée.

Utilisation de Logman

La procédure suivante décrit comment utiliser Logman avec votre application VSS.

Pour utiliser Logman avec votre application VSS

  1. Utilisez la commande suivante pour commencer le traçage :

    logman start vss -o *x:\*vss.etl -ets -p {9138500e-3648-4edb-aa4c-859e9f7b7c38} 0xfff 170

    Remarque

    Remplacez « x:\ » par le chemin vers le répertoire où vous souhaitez que le fichier journal de traçage soit stocké.

     

  2. Utilisez la commande suivante pour arrêter le traçage :

    logman stop vss -ets

Le fichier journal de traçage est *x:\*vss.etl.

Pour plus d’informations sur l’outil Logman, veuillez consulter Logman.

Utilisation de Tracelog

La procédure suivante décrit comment utiliser Tracelog.

Pour utiliser Tracelog

  1. Créez un fichier texte nommé vss.ctl contenant uniquement le texte suivant :

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

  2. Utilisez la commande suivante pour commencer le traçage :

    tracelog -start vss -f *x:\*vss.etl -guid vss.ctl -flag 0xff -level 0xaa

    Remarque

    Remplacez « x:\ » par le chemin vers le répertoire où vous souhaitez que le fichier journal de traçage soit stocké.

     

  3. Utilisez la commande suivante pour arrêter le traçage :

    tracelog -stop vss

Le fichier journal de traçage est *x:\*vss.etl.

Pour plus d’informations sur l’outil Tracelog, consultez Tracelog.