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.

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 .