Prostřednictvím tohoto tématu můžete konfigurovat a spravovat nastavení úrovně protokolování.
Chcete-li zobrazit tuto stránku administrativní konzoly, klepněte na volbu .
Pomocí úrovní protokolování můžete řídit, které události jsou zpracovávány protokolovacími funkcemi Java. Pokud změníte úroveň modulu protokolování, bude tato změna předána dále do podřízených objektů modulu protokolování.
- Zakázání protokolování a trasování potenciálně citlivých dat
- Aplikační server obsahuje seznam modulů protokolování, které jsou známé tím, že pokud jsou povoleny, mohou zapisovat citlivé informace do protokolů a trasování. Pokud například povolíte jisté moduly protokolování související s HTTP na úrovni FINEST, může dojít k uložení důvěrných, uživatelem zadaných informací z požadavků HTTP do souborů trasování. Chcete-li zajistit, aby se server vyvaroval povolení těchto modulů protokolování na úrovních, o nichž je známo, že jsou používány pro potenciálně citlivé informace, zaškrtněte políčko Zakázat protokolování a trasování potenciálně citlivých dat. Po spuštění serveru nebo při změně specifikace úrovně podrobností protokolu za běhu bude server porovnávat seznam modulů protokolování a úrovní určených ve specifikaci úrovně podrobností protokolu se seznamem modulů protokolování a úrovní ze seznamu citlivých modulů protokolování, a podle potřeby aktualizuje specifikaci úrovně podrobností protokolu.
- Změnit úrovně podrobností protokolu
Zadejte požadovanou úroveň podrobností protokolování, která určuje, zda mají být trasovány komponenty, balíky nebo skupiny. Řetězec úrovně podrobností protokolování musí splňovat specifická gramatická pravidla popsaná v tomto tématu. Řetězec úrovně podrobností protokolování lze zadat přímo nebo jej lze vygenerovat pomocí grafického rozhraní trasování.
Pokud přejdete na kartu Konfigurace a rozbalíte nabídku Komponenty a skupiny, bude zobrazen statický seznam známých komponent, balíků a skupin. Tento seznam nemusí být vyčerpávající.
Přejdete-li na kartu Běhové prostředí a rozbalíte nabídku Komponenty a skupiny, bude zobrazen seznam komponent, balíků a skupin se všemi komponentami, které jsou registrovány ve spuštěném aplikačním serveru a ve statickém seznamu.
Specifikace úrovně podrobností protokolu má následující formát:<komponenta> = <úroveň>
kde <komponenta> je komponenta, pro kterou je nastavována úroveň podrobností protokolu, a<úroveň> je některá z platných úrovní modulu protokolování (vypnuto, nejzávažnější, závažné, varování, prověřování, informace, konfigurace, detaily, podrobné, podrobnější, nejpodrobnější, všechny). Více specifikací úrovní podrobností je třeba oddělit znakem dvojtečky (:).
Předcházení potížím: Klauzule zahrnuté ve specifikaci trasování se načítají v pořadí, ve kterém jsou uvedeny v řetězci. Pokud je ve specifikaci trasování uvedeno několik variací klauzule *=info, poslední uvedenou hodnotou je hodnota, která určuje úroveň trasování pro protokolování systému. Pokud zadáte hodnotu *=info jako poslední klauzuli, trasování se vyskytne na úrovni informací bez ohledu na ostatní klauzule určené v řetězci trasování. Následující řetězec trasování:
je například ekvivalentní k následujícímu zápisu:*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all
Důvodem je to, že klauzule final přepisuje všechny klauzule, které byly v řetězci uvedeny před ní. gotcha*=allKomponenty odpovídají balíkům a třídám Java nebo kolekcím balíků Java. Chcete-li označit komponenty, které obsahují všechny třídy ve všech balících zahrnutých ve specifikované komponentě, použijte znak hvězdičky (*). Příklad:- *
- Určuje veškerý trasovatelný kód spuštěný v aplikačním serveru, včetně systémového kódu produktu a kódu zákazníků.
- com.ibm.ws.*
- Určuje všechny třídy s názvem balíku začínajícím řetězcem com.ibm.ws.
- com.ibm.ws.classloader.JarClassLoader
- Určuje pouze třídu JarClassLoader.
Pokud je prováděn výběr z obou seznamů Skupiny a Komponenty, může při nastavování úrovně podrobností z administrativní konzoly dojít k chybě. V některých případech může při přidání položky z jednoho seznamu dojít ke ztrátě položky z druhého seznamu. Chcete-li se tomuto problému vyhnout, zadejte specifikaci úrovně podrobností protokolování přímo do pole pro zadání úrovně podrobností protokolování.
Předcházení potížím: Hodnoty úrovně protokolování rozlišují velikost písmen a začínají malým písmenem.gotcha| Úroveň protokolování verze 6 a vyšší | Obsah/význam |
|---|---|
| off | Protokolování je vypnuto. |
| fatal | Ve zpracování úlohy nelze pokračovat a komponenta, aplikace ani server nebudou funkční. |
| závažné | Ve zpracování úlohy nelze pokračovat, avšak komponenta, aplikace a server mohou být stále funkční. Tato úroveň může také indikovat hrozící neopravitelnou chybu. |
| varování | Potenciální nebo hrozící chyba. Tato úroveň může také indikovat postupné selhání (například možné nevracení paměti prostředky). |
| prověřování | Na stav serveru nebo prostředky má vliv závažná událost. |
| informace | Obecné informace o celkovém průběhu zpracování úlohy. |
| konfigurace | Stav nebo změna konfigurace. |
| detaily | Obecné informace s podrobnostmi o průběhu zpracování dílčích úloh. |
| podrobné | Informace trasování - obecné údaje trasování + vstupní, koncové a návratové hodnoty metod. |
| podrobnější | Informace trasování - podrobné údaje trasování. |
| nejpodrobnější | Informace trasování - podrobnější údaje trasování obsahující všechna data potřebná k ladění problémů. |
| all | Protokolovány jsou všechny události. Pokud vytvoříte vlastní úrovně, bude úroveň Vše obsahovat i tyto úrovně. Tak lze zajistit ještě podrobnější trasování než na úrovni Nejpodrobnější. |
[Základní režim protokolování] Informace trasování, které jsou událostmi na úrovních Podrobné, Podrobnější a Nejpodrobnější, mohou být zapsány pouze do protokolu trasování. Pokud tedy nepovolujete službu Diagnostické trasování, nebude mít nastavení úrovně protokolování Podrobné, Podrobnější či Nejpodrobnější na protokolování dat žádný vliv.
- Korelace
- Zadejte nastavení korelace, které chcete povolit. Zaškrtnutím políčka Povolit korelace protokolu a trasování povolíte korelaci pro aplikační server. Zrušením zaškrtnutí políčka Povolit korelace protokolu a trasování zakážete korelaci pro aplikační server. Vyberte podle potřeby volby Zahrnout ID požadavků do souborů protokolu a trasování, Zahrnout ID požadavků do souborů protokolu a trasování a záznamů korelace protokolu nebo Zahrnout ID požadavků do souborů protokolu a trasování, vytvořit záznamy korelace protokolu a zachytit snímky dat.
Doporučené postupy: Povolte, aby XCT zahrnoval ID požadavků do souborů protokolů a trasování, když chcete vidět, které položky protokolů a sledování ve všech podprocesech a procesech aplikačního serveru se vztahují ke stejnému požadavku. ID požadavků jsou zaznamenávány pouze při použití režimu protokolování a trasování HPEL a mohou být zobrazeny nebo použity k filtrování pomocí příkazu logViewer. bprac Doporučené postupy: Povolte, aby XCT vytvářel záznamy protokolu korelací, když chcete protokolovat větvení požadavků mezi podprocesy a procesy a zobrazit víc informací o každém požadavku.
Povolíte-li nástroji XCT vytváření záznamů protokolu korelací, může to mít významný dopad na výkon systému; proto je tato možnost vhodná zejména pro testovací a vývojová prostředí.bprac Doporučené postupy: Povolte, aby XCT zaznamenával snímky dat, když chcete ukládat celá těla požadavků a odpovědí do systému souborů. Povolíte-li nástroji XCT zachytávání snímků dat, může to mít významný dopad na výkon systému; proto je tato možnost vhodná zejména pro testovací a vývojová prostředí. Nástroj XCT zachytává snímky dat pro žádosti o zprávy a odezvy zpracovávané sběrnicí SIBus.bprac Předcházení potížím: Snímky dat jsou zachytávány a zapisovány do adresáře $SERVER_LOG_ROOT/snapdata.
Aplikační server standardně neprovádí úklid souborů v tomto adresáři. Je-li povoleno zachytávání snímků dat, bude třeba, abyste soubory z tohoto adresáře pravidelně odstraňovali sami. Ve snímcích dat je uložen veškerý obsah požadavků a odezev včetně případných důvěrných informací. Tato možnost nemusí být vhodná pro použití v provozních prostředích.gotcha
- Uložit do konfigurace také změny běhového nastavení
- Určuje, že změny jsou prováděny v dynamickém stavu spuštěného serveru i v konfiguraci serveru, přičemž se projeví při příštím spuštění. Není-li toto políčko zaškrtnuto, server nezkopíruje nastavení do konfigurace serveru.