Partager via


Global Logger Trace Session

Une session de suivi Global Logger enregistre les événements qui se produisent pendant le processus de démarrage avant que le système ne soit entièrement opérationnel, tels que les événements générés par les pilotes de périphérique. Il s’agit d’une session de trace réservée intégrée à Windows.

Les sessions de suivi d’enregistreur d’événements globaux écrivent toujours des messages dans un journal de suivi. Global Logger ne prend pas en charge les sessions de suivi en temps réel ni les sessions de suivi mises en mémoire tampon.

Étant donné que Global Logger doit être disponible au début du processus de démarrage du système d’exploitation, il est démarré et configuré à l’aide d’entrées de Registre (dans la sous-clé HKLM\SYSTEM\CurrentControlSet\Control\WMI\GlobalLogger ) au lieu d’appels de fonction. Après le démarrage, l’enregistreur d’événements global se comporte comme une session de suivi d’événements standard.

La session de trace Global Logger utilise un nom de session réservé, « GlobalLogger ». Le GUID du contrôle est représenté par la constante GlobalLoggerGuid. Vous créez une session de suivi Global Logger, puis redémarrez l’ordinateur pour démarrer la session de suivi. Une seule session de trace Global Logger peut s’exécuter sur l’ordinateur à la fois.

Pour créer une session de suivi Global Logger, utilisez Tracelog. Il crée automatiquement la sous-clé de Registre et les entrées qui stockent les options de session de suivi. La session de suivi De l’enregistreur d’événements global démarre lorsque vous redémarrez l’ordinateur. Pour plus d’informations, consultez Syntaxe de la commande Tracelog.

Pour mettre en forme les messages de suivi à partir d’une session de suivi Global Logger, utilisez Tracefmt avec system.tmf, un fichier de format de message de trace inclus dans le WDK.

Étant donné que la session Global Logger est déclenchée par des entrées de Registre, elle s’exécute chaque fois que les entrées apparaissent dans le Registre. Pour empêcher la session Global Logger de démarrer chaque fois que le système démarre, définissez la valeur de l’entrée Start sur 0 ou supprimez toutes les entrées de Registre.

Vous pouvez convertir une session de suivi de l’enregistreur d’événements global en session de suivi de l’enregistreur d’événements du noyau NT, ce qui permet de suivre le noyau pendant le processus de démarrage. Pour plus d’informations, consultez Session d’enregistreur d’événements global au moment du démarrage.

Les fournisseurs de trace, tels que les pilotes en mode noyau et les applications en mode utilisateur, peuvent se connecter à la session de suivi Global Logger. Cela vous permet de suivre un pilote ou un autre fournisseur de trace pendant le démarrage du système. Pour plus d’informations, consultez Journalisation à la session d’enregistreur d’événements global.

Limitations de la session de suivi de l’enregistreur d’événements global

La session de suivi Global Logger est très utile, mais il est important de connaître ses limitations :

Vous ne pouvez exécuter qu’une seule session Global Logger à la fois.

La session Global Logger n’envoie pas de notification d’activation aux fournisseurs.

Les entrées du registre Global Logger restent dans le registre et sont effectives jusqu’à ce que vous les réinitialisiez ou les supprimiez manuellement, ou que vous utilisiez la commande tracelog -remove . Jusqu’à ce que vous les réinitialisiez, la session Global Logger démarre chaque fois que vous démarrez le système.

L’enregistreur d’événements Windows ACPI est activé de manière permanente pour la session de suivi de l’enregistreur d’événements global. Les messages de trace de cet enregistreur d’événements s’affichent dans le journal des traces.

Si une session de trace standard démarre alors qu’un pilote se connecte à la session Global Logger, le pilote bascule et démarre la journalisation dans la session de trace standard.

Entrées du registre d’enregistreurs d’événements globaux

Le tableau suivant montre les entrées de Registre qui configurent la session Global Logger. Ces entrées se trouvent dans la sous-clé HKLM\SYSTEM\CurrentControlSet\Control\WMI\GlobalLogger . Seule l’entrée Démarrer est requise.

En plus des entrées de Registre dans cette table, vous pouvez également ajouter une sous-clé ControlGUID sous la sous-clé GlobalLogger pour représenter un fournisseur de trace, tel qu’un pilote, qui se journalise dans la session de suivi Global Logger. Pour plus d’informations, consultez Journalisation dans la session d’enregistreur d’événements global.

Entrée Type de données Description

Start

REG_DWORD

Lorsqu’elle est définie sur 1 (activé), la session Global Logger démarre la prochaine fois que le système démarre.

0 = off, 1=on

BufferSize

REG_DWORD

Spécifie la taille de chaque mémoire tampon (en Ko). La valeur par défaut est 0x40 (64 Ko).

ClockType

REG_DWORD

Spécifie le minuteur utilisé pour les horodatages de message de trace.

À compter de Windows Vista, la valeur par défaut est 1. Sur les systèmes d’exploitation antérieurs à Windows Vista, la valeur par défaut est 2.

1 = valeur du compteur de performances (haute résolution)

2 = Minuteur système

3 = horloge de cycle du processeur

EnableKernelFlags

REG_BINARY

Convertit la session Global Logger en session de suivi de l’enregistreur d’événements du noyau NT et spécifie les événements inclus dans la trace du noyau.

Pour plus d’informations, consultez Session d’enregistreur d’événements global au moment du démarrage.

FileCounter

REG_DWORD

Stocke le nombre de fichiers journaux de trace d’événements générés par les sessions Global Logger.

Le système incrémente cette valeur jusqu’à ce qu’elle atteigne la valeur de FileMax. Ensuite, il réinitialise la valeur à 0.

Ce compteur empêche le système de remplacer un fichier journal de trace Global Logger.

FileMax

REG_DWORD

Spécifie le nombre maximal de fichiers journaux de trace d’événements autorisés sur le système.

Lorsque le nombre de journaux de trace atteint le maximum spécifié, le système commence à remplacer les journaux, en commençant par le plus ancien.

La valeur par défaut est 0, ce qui signifie qu’il n’y a pas de maximum.

FileName

REG_SZ

Chemin d’accès (facultatif) et nom de fichier du fichier journal de trace d’événements. La valeur par défaut est %SystemRoot%\System32\LogFiles\WMI\trace.log.

FlushTimer

REG_DWORD

Spécifie la fréquence (en secondes) à laquelle les mémoires tampons de trace sont vidées de force. Ce vidage forcé s’ajoute au vidage automatique qui se produit chaque fois qu’une mémoire tampon est pleine et lorsque la session de suivi s’arrête.

La valeur par défaut est 0. Par défaut, les mémoires tampons sont vidées uniquement lorsqu’elles sont pleines.

La durée minimale de vidage est de 1 seconde.

LogFileMode

REG_DWORD

Spécifie les options de session de journal.

Pris en charge uniquement dans Windows Vista et les versions ultérieures de Windows.

MaximumBuffers

REG_DWORD

Spécifie le nombre maximal de mémoires tampons pouvant être allouées pour la session. La valeur par défaut est 0x19 (25).

MaximumFileSize

REG_DWORD

Spécifie la taille maximale du fichier journal de trace d’événements. Par défaut, il n’existe aucune taille de fichier maximale.

MinimumBuffers

REG_DWORD

Spécifie le nombre de mémoires tampons allouées au démarrage de la session. La valeur par défaut est 0x3.

État

REG_DWORD

Stocke le code de retour de la tentative de démarrage d’une session de trace Global Logger.

Si la session n’a pas pu démarrer, la valeur de cette entrée est un code d’erreur Win32. Si la session a démarré, la valeur de cette entrée est ERROR_SUCCESS.

Ces entrées de Registre que vous créez restent dans le registre et sont effectives jusqu’à ce que vous les supprimiez ou modifiez leurs valeurs. Par conséquent, une fois la session Global Logger exécutée, utilisez la commande tracelog -remove GlobalLogger pour définir la valeur de l’entrée Start sur 0 et supprimer les autres entrées de Registre Global Logger. Sinon, la session Global Logger s’exécute chaque fois que vous redémarrez l’ordinateur, et le fichier journal résultant peut devenir très volumineux.

Constantes du mode journalisation

Le tableau suivant affiche les valeurs valides pour l’entrée de Registre LogFileMode dans la sous-clé HKLM\System\CurrentControlSet\Control\WMI\GlobalLogger . Cette entrée est utilisée pour définir les options d’une session de suivi Global Logger, notamment celles pour les sessions de suivi en temps réel, les sessions de suivi privées, la journalisation circulaire et la mise en mémoire tampon (aucun journal). Cette entrée de Registre est prise en charge uniquement dans Windows Vista et les versions ultérieures de Windows.

Cette entrée de Registre correspond au membre LogFileMode de la structure EVENT_TRACE_PROPERTIES. Ses valeurs correspondent aux constantes du mode de journalisation. La structure EVENT_TRACE_PROPERTIES et les constantes du mode de journalisation sont décrites dans la documentation Microsoft Windows SDK.

Ce tableau est affiché ici pour afficher les valeurs hexadécimales des constantes. Utilisez ces valeurs ou une somme de ces valeurs pour représenter la constante dans l’entrée de Registre LogFileMode .

Valeur Constante Description

0x0

EVENT_TRACE_FILE_MODE_NONE

Aucun fichier journal de trace des événements n’est créé.

0x1

EVENT_TRACE_FILE_MODE_SEQUENTIAL

Les fichiers journaux des traces d’événements sont séquentiels.

0x2

EVENT_TRACE_FILE_MODE_CIRCULAR

Les fichiers journaux des traces d’événements sont circulaires.

0x4

EVENT_TRACE_FILE_MODE_APPEND

Ajoutez des messages de trace à un fichier journal existant. Ce mode est valide uniquement avec les fichiers séquentiels.

0x8

EVENT_TRACE_FILE_MODE_NEWFILE

Créez un fichier journal de suivi des événements chaque fois que le fichier existant atteint la valeur de l’entrée MaximumFileSize (voir le tableau ci-dessus).

0x20

EVENT_TRACE_FILE_MODE_PREALLOCATE

Réserve de l’espace pour le fichier journal de trace des événements.

Valide uniquement avec EVENT_TRACE_FILE_MODE_SEQUENTIAL ou EVENT_TRACE_FILE_MODE_CIRCULAR, et non valide avec EVENT_TRACE_FILE_MODE_NEWFILE.

0x40

EVENT_TRACE_NONSTOPPABLE_MODE

Un appel à StopTrace n’arrête pas la session de trace.

Cette fonctionnalité empêche les utilisateurs d’arrêter les sessions de suivi dont le système a besoin pour le diagnostic et le réglage.

0x100

EVENT_TRACE_REAL_TIME_MODE

Spécifie une session de suivi en temps réel.

0x200

EVENT_TRACE_DELAY_OPEN_FILE_MODE

À usage interne uniquement.

0x400

EVENT_TRACE_BUFFERING_MODE

Les événements sont conservés dans les mémoires tampons. Ils ne sont jamais écrits dans un fichier journal ou remis à un consommateur de trace.

0x800

EVENT_TRACE_PRIVATE_LOGGER_MODE

Spécifie une session de trace privée. Cet indicateur n’est pas valide pour une session de suivi Global Logger.

0x1000

EVENT_TRACE_ADD_HEADER_MODE

À usage interne uniquement.

0x2000

EVENT_TRACE_USE_KBYTES_FOR_SIZE

Interpréter la valeur de MaximumFileSize en Ko au lieu de Mo.

0x4000

EVENT_TRACE_USE_GLOBAL_SEQUENCE

Génère des numéros de séquence globaux pour les messages de trace. Ces numéros sont uniques pour toutes les sessions de suivi sur l’ordinateur.

Par défaut, les messages de trace n’ont pas de numéros de séquence.

0x8000

EVENT_TRACE_USE_LOCAL_SEQUENCE

Génère des numéros de séquence locaux pour les messages de trace. Ces numéros sont uniques dans la session de trace.

Par défaut, les messages de trace n’ont pas de numéros de séquence.

0x10000

EVENT_TRACE_RELOG_MODE

À usage interne uniquement.

0x80000

EVENT_TRACE_KD_FILTER_MODE

Redirige les messages de trace vers le débogueur du noyau et définit la taille de la mémoire tampon de trace sur 3 Ko, la taille maximale de la mémoire tampon pour le débogueur.

0x1000000

EVENT_TRACE_MODE_RESERVED

Non valide pour une session de suivi De l’enregistreur d’événements global.

0x01000000

EVENT_TRACE_USE_PAGED_MEMORY

Allouez des mémoires tampons de session de trace à partir de la mémoire paginable. Par défaut, les mémoires tampons sont allouées à partir de la mémoire non pagéable.