Sessão de rastreamento do registrador global

Uma sessão de rastreamento do Global Logger registra eventos que ocorrem durante o processo de inicialização antes que o sistema esteja totalmente operacional, como eventos gerados por drivers de dispositivo. É uma sessão de rastreamento reservada que é incorporada no Windows.

As sessões de rastreamento do Global Logger sempre gravam mensagens em um log de rastreamento. O Global Logger não suporta sessões de rastreamento em tempo real ou sessões de rastreamento em buffer.

Como o Global Logger deve estar disponível no início do processo de inicialização do sistema operacional, ele é iniciado e configurado usando entradas do Registro (na subchave HKLM\SYSTEM\CurrentControlSet\Control\WMI\GlobalLogger ), em vez de chamadas de função. Depois de começar, o Global Logger se comporta como uma sessão regular de rastreamento de eventos.

A sessão de rastreamento do Global Logger usa um nome de sessão reservado, "GlobalLogger". O GUID de controle é representado pela constante, GlobalLoggerGuid. Crie uma sessão de rastreamento Global Logger e, em seguida, reinicie o computador para iniciar essa sessão de rastreamento. Apenas uma sessão de rastreamento do Global Logger pode ser executada no computador de cada vez.

Para criar uma sessão de rastreamento do Global Logger, use Tracelog. Ele cria automaticamente a subchave do Registro e entradas que armazenam opções de sessão de rastreamento. A sessão de rastreamento do Global Logger é iniciada quando você reinicia o computador. Para obter mais informações, consulte Sintaxe de comando Tracelog.

Para formatar as mensagens de rastreio de uma sessão de rastreio do Global Logger, utilize o Tracefmt com o system.tmf, um ficheiro de formato de mensagens de rastreio incluído no WDK.

Como a sessão Global Logger é acionada por entradas do Registro, ela é executada sempre que as entradas aparecem no Registro. Para impedir que a sessão do Global Logger seja iniciada sempre que o sistema for iniciado, defina o valor da entrada Start como 0 ou exclua todas as entradas do Registro.

Você pode converter uma sessão de rastreamento do Global Logger em uma sessão de rastreamento do NT Kernel Logger, rastreando assim o kernel durante o processo de inicialização. Para obter informações, consulte Boot-time Global Logger Session

Os provedores de rastreamento, como drivers de modo kernel e aplicativos de modo de usuário, podem fazer logon na sessão de rastreamento do Global Logger. Isso permite que você rastreie um driver ou outro provedor de rastreamento durante a inicialização do sistema. Para obter informações, consulte Registo na sessão do gravador global

Limitações da sessão Global Logger Trace

A sessão de rastreamento do Global Logger é muito útil, mas é importante estar ciente de suas limitações:

Você pode executar apenas uma sessão do Global Logger de cada vez.

A sessão Global Logger não envia notificação de habilitação para provedores.

As entradas do Registro Global Logger permanecem no Registro e são efetivas até que você as redefina ou exclua manualmente ou use o comando tracelog -remove . Até que você os resete, a sessão do Global Logger é iniciada toda vez que você inicia o sistema.

O registador ACPI do Windows está permanentemente ativado para a sessão de rastreio do Global Logger. As mensagens de rastreamento desse registrador aparecem no log de rastreamento.

Se uma sessão de rastreamento padrão for iniciada enquanto um driver estiver registrando na sessão do Global Logger, o driver alternará e iniciará o registro na sessão de rastreamento padrão.

Entradas do Registo Global Logger

A tabela a seguir mostra as entradas do Registro que configuram a sessão do Global Logger. Essas entradas estão na subchave HKLM\SYSTEM\CurrentControlSet\Control\WMI\GlobalLogger . Apenas a entrada Start é obrigatória.

Além das entradas do Registo nesta tabela, pode também adicionar uma subchave ControlGUID sob a subchave GlobalLogger para representar um fornecedor de rastreio, como um driver, que regista na sessão de rastreamento do Global Logger. Para obter informações, consulte Registo de Eventos na Sessão do Registrador Global.

Essas entradas do Registro que você cria permanecem no Registro e são efetivas até que você as exclua ou altere seus valores. Portanto, depois que a sessão do Global Logger for executada, use o comando tracelog -remove GlobalLogger para definir o valor da entrada Start como 0 e excluir as outras entradas do Registro Global Logger. Caso contrário, a sessão do Global Logger será executada sempre que você reiniciar o computador e o arquivo de log resultante poderá crescer muito.

Constantes do modo de registro

A tabela a seguir exibe os valores válidos para a entrada do Registro LogFileMode na subchave HKLM\System\CurrentControlSet\Control\WMI\GlobalLogger . Essa entrada é usada para definir opções para uma sessão de rastreamento do Global Logger, incluindo aquelas para sessões de rastreamento em tempo real, sessões de rastreamento privado, log circular e buffering (sem log). Esta entrada de registo é suportada apenas no Windows Vista e versões posteriores do Windows.

Essa entrada do Registro corresponde ao membro LogFileMode da estrutura EVENT_TRACE_PROPERTIES. Seus valores correspondem às constantes do modo de registro. A estrutura EVENT_TRACE_PROPERTIES e as constantes do modo de registo são descritas na documentação do SDK do Microsoft Windows.

Esta tabela é exibida aqui para mostrar os valores hexadecimais das constantes. Use esses valores ou uma soma desses valores para representar a constante na entrada do Registro LogFileMode .