Session de trace d’enregistreur d’événements global

Une session de suivi Global Logger enregistre les événements qui se produisent pendant le processus de démarrage avant que le système soit entièrement opérationnel, par exemple 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 Global Logger écrivent toujours des messages dans un journal de suivi. Global Logger ne prend pas en charge les sessions de suivi en temps réel ou les sessions de trace 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 des appels de fonction. Après avoir démarré, Global Logger 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 de contrôle est représenté par la constante GlobalLoggerGuid. Vous créez une session de trace Global Logger, puis redémarrez l’ordinateur pour démarrer la session de trace. Une seule session de trace Global Logger peut s’exécuter sur l’ordinateur à la fois.

Pour créer une session de trace Global Logger, utilisez Tracelog. Il crée automatiquement la sous-clé de Registre et les entrées qui stockent les options de session de trace. La session de suivi Global Logger démarre lorsque vous redémarrez l’ordinateur. Pour plus d’informations, consultez la syntaxe des commandes Tracelog.

Pour mettre en forme les messages de trace à partir d’une session de trace Global Logger, utilisez Tracefmt avec system.tmf, un fichier de format de message de trace inclus dans 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 le démarrage de la session Global Logger chaque fois que le système démarre, définissez la valeur de l’entrée de démarrage sur 0 ou supprimez toutes les entrées du Registre.

Vous pouvez convertir une session de trace d’enregistreur d’événements global en session de trace de l’enregistreur d’événements du noyau NT, ce qui permet de tracer le noyau pendant le processus de démarrage. Pour plus d’informations, consultez Session de journalisation globale au 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 trace 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 de la session d'enregistreur global

Limitations de la session de journalisation du logger global

La session de trace 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 de Registre Global Logger restent dans le Registre et sont effectives jusqu’à ce que vous les réinitialisiez ou supprimez-les manuellement, ou utilisez 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 ACPI Windows est activé définitivement pour la session de trace Global Logger. Les messages de suivi de cet enregistreur d’événements s’affichent dans le journal des traces.

Si une session de suivi standard démarre pendant qu’un pilote se connecte à la session Global Logger, le pilote bascule et commence à se connecter à la session de trace standard.

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

Le tableau suivant présente 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 De début est requise.

Outre les entrées de Registre de 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 connecte à la session de trace Global Logger. Pour plus d’informations, consultez Journalisation à la session d’enregistreurs d’événements globaux.

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 le journal des traces -remove commande GlobalLogger pour définir la valeur de l’entrée de démarrage 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 croître très volumineux.

Constantes en 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 permet de définir des options pour une session de trace Global Logger, y compris celles des sessions de suivi en temps réel, des sessions de trace 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 en mode journalisation sont décrites dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows.

Ce tableau s’affiche 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 .