Commandes de contrôle TraceView
Remarque
Les options de ligne de commande TraceView sont déconseillées. Utilisez tracepdb.exe et tracefmt.exe pour analyser les fichiers PDB dans des fichiers TMF et analyser des fichiers .etl en texte, respectivement.content
Utilisez une commande de contrôle Traceview pour gérer les sessions de suivi, notamment le démarrage et l’arrêt de la session, l’activation et la désactivation des fournisseurs, la mise à jour des propriétés de la session de suivi et le vidage des mémoires tampons de trace.
traceview {-start | -stop | -update | -enable | -disable | -flush | -q} SessionName [Parameters]
traceview {-enumguid | -l | -h | -x}
Paramètres de commande
Actions
| Pour | Description |
|---|---|
| -commencer | Démarre la session de trace spécifiée. |
| -arrêter | Arrête la session de trace spécifiée. |
| -mettre à jour | Met à jour les propriétés de la session de trace spécifiée. |
| -Activer | Active les fournisseurs pour la session de trace spécifiée. |
| -désactiver | Désactive les fournisseurs pour la session spécifiée. |
| -rougir | Vide les mémoires tampons actives de la session de trace spécifiée. Ce vidage forcé s’ajoute aux vidages automatiques qui se produisent lorsqu’une mémoire tampon est pleine et lorsque la session de trace s’arrête. |
| -q | Interrogez l’état de la session de trace spécifiée. |
| -enumguid | Répertorie les fournisseurs sur le système qui sont inscrits auprès du suivi d’événements pour Windows (ETW). |
| -l | Répertorier toutes les sessions de suivi en cours d’exécution sur l’ordinateur. |
| -x | Arrête toutes les sessions de suivi. |
Paramètres
Nom_session
Lorsqu’il est utilisé avec -start, SessionName est un nom que vous sélectionnez pour représenter la session de trace. Avec toutes les autres commandes, SessionName identifie la session de trace.
-f [LogFile]
Lorsqu’il est utilisé avec -start, -f démarre une session de journal de suivi. LogFile spécifie le chemin d’accès (facultatif) et le nom de fichier du fichier journal de trace d’événements (.etl). La valeur par défaut est C :\LogFile.etl.
Lorsqu’il est utilisé avec -update, -f envoie tous les nouveaux messages de trace uniquement au journal de suivi spécifié. Utilisez ce paramètre pour convertir une session de trace en temps réel en session de journal de suivi ou pour démarrer un nouveau journal de suivi pour une session de journal de suivi existante. Pour envoyer des messages de suivi à un consommateur de trace en temps réel et à un journal de suivi, utilisez les paramètres -rt et -f dans la commande -update .
-Rt
Lorsqu’il est utilisé avec -start, -rt démarre une session de trace en temps réel (une session de journal de suivi (-f) est la valeur par défaut.) Si vous utilisez -rt et -f dans une commande -start , les messages de trace sont envoyés au consommateur de trace et à un fichier journal de suivi des événements.
Lorsqu’il est utilisé avec -update, -rt ajoute la remise de messages en temps réel à une session de journal de suivi. Tous les nouveaux messages de suivi sont envoyés directement au consommateur de trace (comme dans une session de suivi en temps réel), en plus d’un journal de suivi.
-guid {#GUID GUIDFile | }
Spécifie un ou plusieurs fournisseurs de trace. Utilisez - start pour activer les fournisseurs pour une session de trace. Utilisez - enable to enable to enable the providers or to change their -flag or -level values. Utilisez - disable pour spécifier les fournisseurs à désactiver.
GUID peut spécifier un GUID de contrôle (précédé d’un signe numérique (#)) ou le chemin d’accès (facultatif) et le nom de fichier d’un fichier texte, tel qu’un fichier GUID de contrôle (.ctl), qui contient les GUID de contrôle d’un ou plusieurs fournisseurs de trace.
Si vous omettez le paramètre -guid à partir d’une commande -start, TraceView démarre une session de trace de l’enregistreur d’événements du noyau NT.
TraceView transmet les valeurs des sous-paramètres suivants aux fournisseurs spécifiés.
| Paramètre | Description |
|---|---|
| SessionName | Lorsqu’il est utilisé avec -start, SessionName est un nom que vous sélectionnez pour représenter la session de trace. Avec toutes les autres commandes, SessionName identifie la session de trace. |
| -f \[LogFile\] | Lorsqu’il est utilisé avec -start, -f démarre une session de journal de suivi. LogFile spécifie le chemin d’accès (facultatif) et le nom de fichier du fichier journal de trace d’événements (.etl). La valeur par défaut est C :\\LogFile.etl. Lorsqu’il est utilisé avec -update, -f envoie tous les nouveaux messages de trace uniquement au [journal de trace](trace-log.md). Utilisez ce paramètre pour convertir une session de trace en temps réel en session de journal de suivi ou pour démarrer un nouveau journal de suivi pour une session de journal de suivi existante. Pour envoyer des messages de suivi à un consommateur de trace en temps réel et à un journal de suivi, utilisez les paramètres -rt et -f dans la commande -update . |
| -Rt | Lorsqu’il est utilisé avec -start, -rt démarre une session de trace en temps réel (une session de journal de suivi (-f) est la valeur par défaut.) Si vous utilisez -rt et -f dans une commande -start , les messages de trace sont envoyés au consommateur de trace et à un fichier journal de suivi des événements. Lorsqu’il est utilisé avec -update, -rt ajoute la remise de messages en temps réel à une session de journal de suivi. Tous les nouveaux messages de suivi sont envoyés directement au consommateur de trace (comme dans une session de suivi en temps réel), en plus d’un [journal de trace](trace-log.md). |
| -guid {\#GUID GUIDFile | } | Spécifie un ou plusieurs fournisseurs de trace. Utilisez - start pour activer les fournisseurs pour une session de trace. Utilisez - enable to enable to enable the providers or to change their -flag or -level values. Utilisez - disable pour spécifier les fournisseurs à désactiver. GUID peut spécifier un [GUID de contrôle](control-guid.md) (précédé d’un signe numérique (\#)) ou du chemin d’accès (facultatif) et du nom de fichier d’un fichier texte, tel qu’un fichier GUID de contrôle (.ctl), qui contient les GUID de contrôle d’un ou plusieurs fournisseurs de trace. Si vous omettez le paramètre -guid à partir d’une commande -start , TraceView démarre une [session de trace de l’enregistreur d’événements du noyau NT](nt-kernel-logger-trace-session.md). |
TraceView transmet les valeurs des sous-paramètres suivants au fournisseur spécifié :
-b BufferSize
Spécifie la taille, en Ko, de chaque mémoire tampon allouée pour la session de trace. Utilisez uniquement avec -start.
La valeur par défaut est déterminée par le nombre de processeurs, la quantité de mémoire physique et le système d’exploitation en cours d’utilisation.
-Min NumberOfBuffers
Spécifie le nombre de mémoires tampons initialement allouées pour le stockage des messages de trace. Utilisez uniquement avec -start.
La valeur par défaut est déterminée par le nombre de processeurs, la quantité de mémoire physique et le système d’exploitation en cours d’utilisation.
-max NumberOfBuffers
Lorsqu’il est utilisé avec -start, -max spécifie le nombre maximal de mémoires tampons allouées pour la session de trace. La valeur par défaut est déterminée par le nombre de processeurs, la quantité de mémoire physique et le système d’exploitation en cours d’utilisation.
Lorsqu’elle est utilisée avec -update, -max modifie le nombre maximal de mémoires tampons allouées pour la session de trace.
-Ft FlushTime
Lorsqu’elle est utilisée avec -start, -ft spécifie la fréquence, en secondes, les mémoires tampons de message de trace sont vidées. Lorsqu’elle est utilisée avec -update, -ft modifie l’heure de vidage par l’heure spécifiée.
La durée minimale de vidage est de 1 seconde. La valeur par défaut est 0 (pas de vidage forcé).
Ce vidage forcé est en plus des vidages qui se produisent automatiquement chaque fois qu’une mémoire tampon de message de trace est pleine et lorsqu’une session de trace s’arrête.
Voir aussi : -flush.
-Bipé
Utilise la mémoire paginable pour les mémoires tampons de message de trace. Par défaut, le suivi d’événements utilise la mémoire non modifiable pour les mémoires tampons. Utilisez uniquement avec -start.
N’utilisez pas ce paramètre lorsque le fournisseur est un pilote qui peut générer des messages de trace à un irQL supérieur à DISPATCH_LEVEL.
Ce paramètre n’est pas pris en charge dans Windows 2000.
-Suiv MaxFileSize
Spécifie la journalisation séquentielle (à la fin du fichier, arrêter l’enregistrement des événements) dans le fichier journal de suivi des événements (.etl). Utilisez uniquement avec -start.
MaxFileSize spécifie la taille maximale du fichier en Mo. Sans valeur MaxFileSize, ce paramètre est ignoré.
La journalisation séquentielle est la valeur par défaut, mais vous pouvez utiliser ce paramètre pour définir la taille maximale du fichier ou utiliser -prealloc. Sans ce paramètre, il n’existe aucune limite de taille de fichier.
-Cir MaxFileSize
Spécifie la journalisation circulaire (à la fin du fichier, enregistrez les nouveaux messages sur les messages les plus anciens) dans le fichier journal de suivi des événements (.etl). Utilisez uniquement avec -start.
MaxFileSize spécifie la taille maximale du fichier en Mo. Sans valeur MaxFileSize, ce paramètre est ignoré.
La valeur par défaut est la journalisation séquentielle sans limite de taille de fichier.
-prealloc
Réserve de l’espace pour le fichier journal de trace d’événements (.etl) avant de l’allouer. Utilisez uniquement avec -start.
Ce paramètre nécessite -seq ou -cir avec MaxFileSize. Il n’est pas valide avec -newfile.
L’indicateur représente une valeur d’indicateur définie dans le fournisseur de trace, au format décimal ou hexadécimal. La valeur par défaut est 0. Les valeurs de 0x01000000 à 0xFF000000 sont réservées à une utilisation ultérieure.
La signification des indicateurs est définie indépendamment par chaque fournisseur de trace. En règle générale, les indicateurs représentent des niveaux de création de rapports de plus en plus détaillés.
Dans une commande -start , la valeur des indicateurs s’applique à tous les fournisseurs de trace dans la session de trace. Pour définir différents indicateurs pour chaque fournisseur de trace, utilisez une commande -enable distincte pour chaque fournisseur de trace.
| Sous-paramètres de -guid | Description |
|---|---|
-Indicateur |
|
|
-level Level |
Spécifie le niveau de trace pour les fournisseurs dans la session de trace. Le niveau détermine les événements générés par le fournisseur de trace. Le niveau représente une valeur de niveau au format décimal ou hexadécimal. La valeur par défaut est 0. La signification de la valeur de niveau est définie indépendamment par chaque fournisseur de trace. En règle générale, le niveau de trace représente la gravité de l’événement (informations, avertissement ou erreur). Dans une commande -start , la valeur de niveau s’applique à tous les fournisseurs de trace dans la session de trace. Pour définir des niveaux différents pour chaque fournisseur de trace, utilisez une commande -enable distincte pour chaque fournisseur de trace. |
| -b BufferSize | Spécifie la taille, en Ko, de chaque mémoire tampon allouée pour la session de trace. Utilisez uniquement avec -start.
La valeur par défaut est déterminée par le nombre de processeurs, la quantité de mémoire physique et le système d’exploitation en cours d’utilisation. |
| -min NumberOfBuffers | Spécifie le nombre de mémoires tampons initialement allouées pour le stockage des messages de trace. Utilisez uniquement avec -start.
La valeur par défaut est déterminée par le nombre de processeurs, la quantité de mémoire physique et le système d’exploitation en cours d’utilisation. |
| -max NumberOfBuffers | Lorsqu’il est utilisé avec -start, -max spécifie le nombre maximal de mémoires tampons allouées pour la session de trace. La valeur par défaut est déterminée par le nombre de processeurs, la quantité de mémoire physique et le système d’exploitation en cours d’utilisation.
Lorsqu’elle est utilisée avec -update, -max modifie le nombre maximal de mémoires tampons allouées pour la session de trace. |
| -ft FlushTime | Lorsqu’elle est utilisée avec -start, -ft spécifie la fréquence, en secondes, les mémoires tampons de message de trace sont vidées. Lorsqu’elle est utilisée avec -update, -ft modifie l’heure de vidage par l’heure spécifiée.
La durée minimale de vidage est de 1 seconde. La valeur par défaut est 0 (pas de vidage forcé). Ce vidage forcé est en plus des vidages qui se produisent automatiquement chaque fois qu’une mémoire tampon de message de trace est pleine et lorsqu’une session de trace s’arrête. Voir aussi : -flush. |
| -age AgeLimit | Lorsqu’elles sont utilisées avec -start, -age spécifie la durée (en minutes) des mémoires tampons de trace inutilisées conservées avant qu’elles ne soient libérées. Lorsqu’elle est utilisée avec -update, -age modifie la limite d’âge par la valeur spécifiée.
La limite d’âge spécifie la durée (en minutes) des mémoires tampons de trace inutilisées avant leur libération. La valeur par défaut est 15 minutes. Ce paramètre est valide uniquement dans Windows 2000. |
| -Bipé | Utilise la mémoire paginable pour les mémoires tampons de message de trace. Par défaut, le suivi d’événements utilise la mémoire non modifiable pour les mémoires tampons. Utilisez uniquement avec -start.
N’utilisez pas ce paramètre lorsque le fournisseur est un pilote qui peut générer des messages de trace à un irQL supérieur à DISPATCH\_LEVEL. Ce paramètre n’est pas pris en charge dans Windows 2000. |
| -seq MaxFileSize | Spécifie la journalisation séquentielle (à la fin du fichier, arrêter l’enregistrement des événements) dans le fichier journal de suivi des événements (.etl). Utilisez uniquement avec -start.
MaxFileSize spécifie la taille maximale du fichier en Mo. Sans valeur MaxFileSize, ce paramètre est ignoré. La journalisation séquentielle est la valeur par défaut, mais vous pouvez utiliser ce paramètre pour définir la taille maximale du fichier ou utiliser -prealloc. Sans ce paramètre, il n’existe aucune limite de taille de fichier. |
| -cir MaxFileSize | Spécifie la journalisation circulaire (à la fin du fichier, enregistrez les nouveaux messages sur les messages les plus anciens) dans le fichier journal de suivi des événements (.etl). Utilisez uniquement avec -start.
MaxFileSize spécifie la taille maximale du fichier en Mo. Sans valeur MaxFileSize, ce paramètre est ignoré. La valeur par défaut est la journalisation séquentielle sans limite de taille de fichier. |
| -prealloc | Réserve de l’espace pour le fichier journal de trace d’événements (.etl) avant de l’allouer. Utilisez uniquement avec -start.
Ce paramètre nécessite -seq ou -cir avec MaxFileSize. Il n’est pas valide avec -newfile. Le système crée le fichier journal de suivi des événements (.etl) avec une taille égale à la valeur MaxFileSize spécifiée à l’aide des paramètres -seq ou -cir . Lorsque vous arrêtez la session, elle réduit le fichier journal à la taille de son contenu. |
| -newfile MaxFileSize | Crée un fichier journal de suivi des événements (.etl) chaque fois que le fichier existant atteint MaxFileSize. Utilisez uniquement avec -start.
MaxFileSize spécifie la taille maximale de chaque fichier journal en Mo. Sans valeur MaxFileSize, ce paramètre est ignoré. Lorsque vous utilisez -newfile, vous devez également utiliser le paramètre -f LogFile et la valeur de LogFile doit être un nom qui inclut les caractères %d indiquent un modèle décimal, par exemple trace%d.etl. Sinon, la commande échoue avec ERROR\_INVALID\_NAME. Windows incrémente la valeur décimale dans le nom de fichier chaque fois qu’il crée un fichier. Ce paramètre n’est pas valide avec la préallocation (-prealloc logging (-cir), avec la session NT Kernel Logger ou pour les sessions de trace privées. Elle n’est pas prise en charge dans Windows 2000. |
| -ajouter | Ajoute les messages de suivi à un fichier journal de suivi d’événements (.etl) existant. La valeur par défaut consiste à créer un fichier. Utilisez uniquement avec -start.
Ce paramètre est valide uniquement sur les fichiers séquentiels et uniquement lorsque -f est utilisé et -rt n’est pas utilisé. Elle n’est pas prise en charge dans Windows 2000. |
| -kd | Redirige les messages de trace vers KD ou Windbg, selon ce qui est attaché. Ce paramètre définit également la taille de la mémoire tampon de trace sur 3 Ko, la taille maximale de la mémoire tampon pour le débogueur et ignore tous les paramètres -b dans la commande. Utilisez uniquement avec -start. |
Commentaires
Une commande traceview sans paramètre ouvre la fenêtre TraceView.
Vous pouvez utiliser la commande TraceView -start pour démarrer une session de trace Global Logger. Pour ce faire, utilisez le format de commande suivant. Contrairement à d’autres commandes, le mot « GlobalLogger » dans ce format de commande respecte la casse.
traceview -start GlobalLogger [parameters]