Sessão de rastreamento do agente global

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

Sessões de rastreamento do Global Logger sempre gravam mensagens em um log de rastreamento. O Logger Global não dá suporte a sessões de rastreamento em tempo real ou a sessões de rastreamento em buffer.

Como o Agente Global 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. Após ser iniciado, o Logger Global 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 do Logger Global e, em seguida, reinicie o computador para iniciar a sessão de rastreamento. Somente uma sessão de rastreamento do Logger Global pode ser executada no computador por vez.

Para criar uma sessão de rastreamento do Global Logger, use Tracelog. Ele cria automaticamente a subchave do Registro e as 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 do Tracelog.

Para formatar as mensagens de rastreamento de uma sessão de rastreamento do Global Logger, use Tracefmt com system.tmf, um arquivo de formato de mensagem de rastreamento incluído no WDK.

Como a sessão do Logger Global é disparada 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 Agente Global em uma sessão de rastreamento do Agente do Kernel NT, rastreando assim o kernel durante o processo de inicialização. Para obter informações, consulte Sessão global de registro durante a inicialização

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

Limitações da Sessão de Rastreamento do Logger Global

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

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

A sessão do Logger Global não envia a notificação de habilitação aos provedores.

As entradas do Registro do Global Logger permanecem no registro e são efetivas até que você as redefina ou exclua manualmente ou use o comando tracelog -remove. Até redefini-los, a sessão do Global Logger começa sempre que você inicia o sistema.

O registrador ACPI do Windows está permanentemente habilitado para a sessão de rastreamento do Logger Global. 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 Logger Global, o driver alterna e passa a registrar na sessão de rastreamento padrão.

Entradas do Registro de Logger Global

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 . Somente a entrada Iniciar é necessária.

Além das entradas do Registro nesta tabela, você também pode adicionar uma subchave ControlGUID sob a subchave GlobalLogger para representar um provedor de rastreamento, como um driver, que registra na sessão de rastreamento do Global Logger. Para obter informações, consulte Registrar em log na Sessão do Logger Global.

Essas entradas do Registro que você cria permanecem no registro e são efetivas até excluí-las ou alterar seus valores. Portanto, depois que a sessão do Agente Global for executada, use o comando tracelog -remove GlobalLogger para definir o valor da entrada Iniciar como 0 e excluir as outras entradas do Registro do Agente Global. Caso contrário, a sessão do Logger Global é executada sempre que você reinicia o computador e o arquivo de log resultante pode ficar muito grande.

Constantes do modo de registro em log

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 Agente Global, incluindo aquelas para sessões de rastreamento em tempo real, sessões de rastreamento privado, registro em log circular e buffer (sem log). Essa entrada do Registro tem suporte 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 de Modo de Logging. A estrutura EVENT_TRACE_PROPERTIES e as constantes de modo de log são descritas na documentação do SDK do Microsoft Windows.

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