Globální sledování Loggeru

Globální relace trasování loggeru zaznamenává události, ke kterým dochází během procesu spouštění předtím, než je systém plně funkční, například události generované ovladači zařízení. Jedná se o rezervovanou relaci trasování, která je integrovaná do Windows.

Globální relace trace loggeru vždy zapisují zprávy do protokolu trasování. Globální protokolovací modul nepodporuje relace trasování v reálném čase ani relace trasování ve vyrovnávací paměti.

Vzhledem k tomu, že globální protokolovací modul musí být k dispozici v rané fázi procesu spouštění operačního systému, spustí se a nakonfiguruje pomocí položek registru (v podklíči HKLM\SYSTEM\CurrentControlSet\Control\WMI\GlobalLogger ) místo volání funkce. Po spuštění se globální protokolovací nástroj chová jako běžná relace trasování událostí.

Trasovací relace Global Logger používá vyhrazený název relace "GlobalLogger". Identifikátor GUID ovládacího prvku je reprezentován konstantou GlobalLoggerGuid. Vytvoříte globální relaci trasování a poté restartujete počítač, aby se spustila relace trasování. Na počítači může současně běžet pouze jedna relace trasování globálního protokolovacího nástroje.

Chcete-li vytvořit relaci trasování globálního loggeru, použijte Tracelog. Automaticky vytvoří podklíč registru a položky, které ukládají možnosti sledování relací. Relace trasování globálního protokolovacího modulu se spustí při restartování počítače. Další informace viz syntaxe příkazu Tracelog.

Chcete-li formátovat trasovací zprávy z globální relace protokolování, použijte Tracefmt se system.tmf, soubor formátu trasovací zprávy, který je součástí WDK.

Vzhledem k tomu, že globální relace loggeru je aktivována položkami registru, spustí se pokaždé, když se položky zobrazí v registru. Pokud chcete zabránit spuštění relace Global Logger při každém startu systému, nastavte hodnotu položky Start na 0 nebo odstraňte všechny položky registru.

Globální loggerovou trasovací relaci můžete převést na trasovací relaci loggeru NT, čímž budete trasovat jádro během spouštění systému. Informace naleznete v tématu Globální relace protokolovacího nástroje za běhu spouštění.

Zprostředkovatelé trasování, jako jsou ovladače režimu jádra a aplikace v uživatelském režimu, se můžou protokolovat do relace trasování globálního protokolovacího nástroje. Díky tomu můžete během spouštění systému trasovat ovladač nebo jiného zprostředkovatele trasování. Informace naleznete v tématu Protokolování do globální relace protokolovacího nástroje.

Omezení relace trasování globálního loggeru

Trasovací relace globálního loggeru je velmi užitečná, ale je důležité vědět o jejích omezeních:

Současně můžete spustit pouze jednu globální relaci záznamníku.

Relace globálního loggeru neodesílá poskytovatelům aktivační oznámení.

Položky registru globálního protokolovacího nástroje zůstanou v registru a jsou účinné, dokud je resetujete nebo neodstraníte ručně, nebo použijte příkaz tracelog -remove . Dokud je neobnovíte, spustí se relace globálního protokolovacího modulu při každém spuštění systému.

Protokolovací nástroj ACPI systému Windows je trvale povolen pro relaci trasování globálního protokolovacího nástroje. Zprávy trasování z tohoto loggeru se objeví v protokolu trasování.

Pokud se spustí standardní relace trasování, když ovladač protokoluje do relace Global Logger, ovladač přepne a začne protokolovat do standardní relace trasování.

Položky registru globálního loggeru

Následující tabulka zobrazuje položky registru, které nastavují konfiguraci relace Global Logger. Tyto položky jsou v podklíči HKLM\SYSTEM\CurrentControlSet\Control\WMI\GlobalLogger . Je vyžadována pouze položka Start .

Kromě položek registru v této tabulce můžete také přidat podklíč ControlGUID pod podklíč GlobalLogger, který představuje zprostředkovatele trasování, například ovladač, který zaznamenává do relace trasování Global Logger. Informace naleznete v tématu Protokolování do globální relace protokolovacího nástroje.

Položka	Datový typ	Popis
Start	REG_DWORD	Při nastavení na 1 (zapnuto) se při příštím spuštění systému spustí relace Global Logger. 0 = vypnuto, 1=zapnuto
VelikostPufru	REG_DWORD	Určuje velikost každé vyrovnávací paměti (v kB). Výchozí hodnota je 0x40 (64 kB).
Typ hodin	REG_DWORD	Určuje časovač použitý pro časové razítko sledovací zprávy. Počínaje systémem Windows Vista je výchozí hodnota 1. V operačních systémech před windows Vista je výchozí hodnota 2. 1 = hodnota čítače výkonu (vysoké rozlišení) 2 = systémový časovač 3 = hodiny cyklu procesoru
EnableKernelFlags	REG_BINÁRNÍ	Převede relaci Global Loggeru na trasovací relaci NT Kernel Loggeru a určuje události zahrnuté v trasování jádra. Informace naleznete v tématu Spuštění globální protokolovací relace.
PočítadloSouborů	REG_DWORD	Ukládá počet souborů protokolu trasování událostí vygenerovaných relacemi Global Logger. Systém tuto hodnotu zvýší, dokud nedosáhne hodnoty FileMax. Potom se hodnota resetuje na 0. Tento čítač zabraňuje systému v přepsání souboru protokolu trasování globálního loggeru.
FileMax	REG_DWORD	Určuje maximální počet souborů protokolu trasování událostí povolených v systému. Když počet protokolů trasování dosáhne zadaného maxima, systém začne přepisovat protokoly počínaje nejstarší. Výchozí hodnota je 0, což znamená, že neexistuje žádné maximum.
Jméno souboru	REG_SZ	Cesta (volitelné) a název souboru protokolu trasování událostí. Výchozí hodnota je %SystemRoot%\System32\LogFiles\WMI\trace.log.
FlushTimer	REG_DWORD	Určuje, jak často (v sekundách) jsou vyrovnávací paměti trasování nuceně vyprázdněny. Toto vynucené vyprázdnění je navíc k automatickému vyprázdnění, ke kterému dochází, když je vyrovnávací paměť plná a když se relace trasování zastaví. Výchozí hodnota je 0. Ve výchozím nastavení se vyrovnávací paměti vyprázdní jenom v případě, že jsou plné. Minimální doba vyprázdnění je 1 sekunda.
RežimSouboruProtokolu	REG_DWORD	Určuje nastavení relace protokolu. Podporováno pouze v systémech Windows Vista a novějších verzích systému Windows.
MaximumBuffers	REG_DWORD	Určuje maximální počet vyrovnávacích pamětí, které lze přidělit pro danou relaci. Výchozí hodnota je 0x19 (25).
MaximumFileSize	REG_DWORD	Určuje maximální velikost souboru protokolu trasování událostí. Ve výchozím nastavení neexistuje maximální velikost souboru.
MinimumBuffers	REG_DWORD	Určuje počet vyrovnávacích pamětí přidělených při spuštění seance. Výchozí hodnota je 0x3.
Stav	REG_DWORD	Uloží návratový kód z pokusu o spuštění trasovací relace nástroje Global Logger. Pokud se relaci nepodařilo spustit, hodnota této položky je kód chyby Win32. Pokud relace začala, hodnota této položky je ERROR_SUCCESS.

Tyto položky registru, které vytvoříte, zůstanou v registru a budou účinné, dokud je neodstraníte nebo nezměníte jejich hodnoty. Proto po spuštění relace Global Logger použijte příkaz tracelog -remove GlobalLogger k nastavení hodnoty položky Start na 0 a odstraňte ostatní položky registru Global Logger. Jinak se relace globálního protokolovacího nástroje spustí při každém restartování počítače a výsledný soubor protokolu se může výrazně zvětšit.

Konstanty režimu protokolování

Následující tabulka zobrazuje platné hodnoty položky registru LogFileMode v podklíči HKLM\System\CurrentControlSet\Control\WMI\GlobalLogger . Tato položka slouží k nastavení možností pro globální relaci trasování, včetně relací trasování v reálném čase, privátních relací trasování, cyklického protokolování a ukládání do vyrovnávací paměti (bez protokolu). Tato položka registru je podporována pouze v systému Windows Vista a novějších verzích systému Windows.

Tato položka registru odpovídá členu LogFileMode struktury EVENT_TRACE_PROPERTIES. Jeho hodnoty odpovídají konstantám režimu protokolování. Struktura EVENT_TRACE_PROPERTIES a konstanty režimu protokolování jsou popsány v dokumentaci sady Microsoft Windows SDK.

Tato tabulka je zde zobrazena tak, aby zobrazovala šestnáctkové hodnoty konstant. Tyto hodnoty nebo součet těchto hodnot můžete použít k reprezentaci konstanty v položce registru LogFileMode .

Hodnota	Konstanta	Popis
0x0	EVENT_TRACE_FILE_MODE_NONE	Nejsou vytvořeny žádné soubory protokolu trasování událostí.
0x1	EVENT_TRACE_FILE_MODE_SEQUENTIAL	Soubory protokolu trasování událostí jsou sekvenční.
0x2	Kruhový režim souboru trasování události	Soubory protokolu trasování událostí jsou cyklický.
0x4	EVENT_TRACE_FILE_MODE_APPEND	Připojte zprávy trasování k existujícímu souboru protokolu. Tento režim je platný pouze sekvenčními soubory.
0x8	EVENT_TRACE_FILE_MODE_NEWFILE	Vytvořte nový soubor protokolu trasování událostí pokaždé, když existující soubor dosáhne hodnoty položky MaximumFileSize (viz tabulka výše).
0x20	EVENT_TRACE_FILE_MODE_PREALLOCATE	Zarezervuje místo pro soubor protokolu trasování událostí. Platné pouze u EVENT_TRACE_FILE_MODE_SEQUENTIAL nebo EVENT_TRACE_FILE_MODE_CIRCULAR, není platné u EVENT_TRACE_FILE_MODE_NEWFILE.
0x40	STOPA_UDÁLOSTÍ_REŽIM_BEZ_ZASTAVENÍ	Volání StopTrace nezastaví relaci trasování. Tato funkcionalita zabrání uživatelům zastavit trasovací relace, které systém vyžaduje k diagnostice a ladění.
0x100	EVENT_TRACE_REAL_TIME_MODE	Určuje relaci trasování v reálném čase.
0x200	Režim zpožděného otevření souboru pro trasování událostí	Pouze pro interní použití.
0x400	EVENT_TRACE_BUFFERING_MODE	Události se uchovávají v vyrovnávacích pamětích. Nikdy se nezapisují do protokolového souboru ani neslouží k doručení klientovi trasování.
0x800	EVENT_TRACE_PRIVATE_LOGGER_MODE	Určuje soukromou trasovací relaci. Tento příznak není platný pro relaci trasování Global Logger.
0x1000	EVENT_TRACE_ADD_HEADER_MODE	Pouze pro interní použití.
0x2000	EVENT_TRACE_USE_KBYTES_FOR_SIZE	Interpretuje hodnotu MaximumFileSize v kB místo MB.
0x4000	EVENT_TRACE_USE_GLOBAL_SEQUENCE	Generuje globální pořadová čísla pro trasovací zprávy. Tato čísla jsou jedinečná pro všechny sledovací relace v počítači. Ve výchozím nastavení zprávy trasování nemají žádná pořadová čísla.
0x8000	EVENT_TRACE_USE_LOCAL_SEQUENCE	Generuje místní pořadová čísla pro trasovací zprávy. Tato čísla jsou jedinečná v rámci relace trasování. Ve výchozím nastavení zprávy trasování nemají žádná pořadová čísla.
0x10000	EVENT_TRACE_RELOG_MODE	Pouze pro interní použití.
0x80000	EVENT_TRACE_KD_FILTER_MODE	Přesměruje zprávy trasování do ladicího programu jádra a nastaví velikost vyrovnávací paměti trasování na 3 kB, což je maximální velikost vyrovnávací paměti pro ladicí program.
0x1000000	EVENT_TRACE_MODE_RESERVED	Není platné pro globální relaci trasování loggeru.
0x01000000	EVENT_TRACE_USE_PAGED_MEMORY	Přidělit vyrovnávací paměti relace trasování ze stránkovatelné paměti. Ve výchozím nastavení se vyrovnávací paměti přidělují z nestránkové paměti.