Sessão de rastreamento de agente global

Uma sessão de rastreamento do Agente Global 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 ao Windows.

As sessões de rastreamento do Agente Global sempre gravam mensagens em um log de rastreamento. O Agente Global não dá suporte a sessões de rastreamento em tempo real ou 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. Depois de iniciar, o Agente Global se comporta como uma sessão regular de rastreamento de eventos.

A sessão de rastreamento do Agente Global usa um nome de sessão reservado, "GlobalLogger". O GUID de controle é representado pela constante GlobalLoggerGuid. Crie uma sessão de rastreamento do Agente Global e reinicie o computador para iniciar a sessão de rastreamento. Somente uma sessão de rastreamento do Agente Global pode ser executada no computador por vez.

Para criar uma sessão de rastreamento do Agente Global, 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 Agente Global é iniciada quando você reinicia o computador. Para obter mais informações, consulte Sintaxe de comando tracelog.

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

Como a sessão do Agente Global é disparada por entradas do Registro, ela é executada sempre que as entradas aparecem no registro. Para impedir que a sessão do Agente Global seja iniciada sempre que o sistema for iniciado, defina o valor da entrada Iniciar 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 do agente de tempo de 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 rastrear um driver ou outro provedor de rastreamento durante a inicialização do sistema. Para obter informações, consulte Registro em log na sessão do agente global

Limitações da sessão de rastreamento do agente global

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

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

A sessão do Agente Global não envia a notificação habilitada aos provedores.

As entradas do Registro do Agente Global 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 Agente Global é iniciada sempre que você inicia o sistema.

O agente de ACPI do Windows está permanentemente habilitado para a sessão de rastreamento do Agente Global. As mensagens de rastreamento desse agente aparecem no log de rastreamento.

Se uma sessão de rastreamento padrão for iniciada enquanto um driver estiver fazendo logon na sessão do Agente Global, o driver alterna e inicia o registro em log para a sessão de rastreamento padrão.

Entradas do Registro de Agente Global

A tabela a seguir mostra as entradas do Registro que configuram a sessão do Agente Global. 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 faz logon na sessão de rastreamento do Agente Global. Para obter informações, consulte Registro em log na Sessão do Agente 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, após a execução da sessão do Agente Global, 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 Agente 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 em 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 em log. A estrutura EVENT_TRACE_PROPERTIES e as constantes do modo de registro em 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 .