Log Begone — mod pro filtrování logovacích zpráv v Minecraftu

Log Begone — mod pro filtrování logovacích zpráv v Minecraftu

Log Begone je užitkový mod pro Minecraft, který odstraňuje určené řádky z konzole a ze souboru latest.log. Vanilla hra zapisuje do logovacího souboru všechna varování, včetně opakujících se zpráv o chybějících strukturách, biomech, blocích či předmětech, které zůstaly po dříve odstraněném obsahu z modpacku. Tento mod takové řádky skrývá, takže konzole i logovací soubor zůstávají během relace čitelné. Funguje jak na klientovi, tak na dedikovaném serveru — filtrování probíhá zvlášť pro každé prostředí, takže synchronizace verzí mezi nimi není potřeba.

K jakým úlohám se používá

Hlavní scénář jsou modpacky, ze kterých byly odstraněny jednotlivé mody nebo obsah. Pozůstatky po takovém odstraňování se projevují jako tisíce stejných varování o "missing entry" nebo o neznámém identifikátoru registru. Bez filtru je konzole během načítání světa zaplavena stovkami takových řádků za sebou a soubor latest.log během jediné relace naroste na desítky megabajtů.

Dalším typickým případem jsou zprávy o pokusech vanilla klienta připojit se k modifikovanému serveru nebo servisní řádky o síťových kanálech. Na serveru s otevřeným portem se takové zprávy objevují při každém skenování klienty třetích stran a vytvářejí šum na pozadí, kvůli kterému je obtížnější zaznamenat skutečné problémy.

Třetím scénářem je optimalizace. Pokud se log zapisuje tisíci řádky za minutu, operace zápisu na disk a formátování zpráv zabírají znatelnou část prostředků. Odstraněním očekávaného šumu ze seznamu filtru lze tyto prostředky vrátit hernímu vláknu — obzvlášť je to znát na serverech s dlouhým časem provozu.

Jak filtrování funguje

Mod zachytává logovací události ještě předtím, než se dostanou na standardní výstup. Pokud zpráva odpovídá jednomu ze zadaných kritérií, není zapsána do konzole ani do souboru. Žádné příkazy, grafické rozhraní ani herní oznámení nejsou: vše se nastavuje pomocí jediného textového konfiguračního souboru.

Podporovány jsou dva režimy porovnávání. První je hledání podřetězce: pokud se v textu zprávy vyskytuje kterákoli z frází ze seznamu, řádek je odříznut. To stačí pro většinu opakujících se varování, protože jejich šablona obvykle obsahuje stabilní, jedinečnou část. Druhým režimem jsou regulární výrazy: pro zprávy, u kterých je třeba zohlednit proměnné prvky (čísla, identifikátory, čas), se zadává vzor v syntaxi Java-regex, a shoda znamená odříznutí řádku.

Konfigurace

Soubor se jmenuje logbegone.json a vytváří se automaticky ve složce config herního profilu při prvním spuštění. Ve verzích do 1.0.1 se používal formát TOML, ale kvůli nekompatibilitě s balením TOML v NeoForge autor převedl konfiguraci na JSON pomocí knihovny GSON.

Struktura souboru

Ve výchozím nastavení oba seznamy obsahují stejné řádky — Disconnecting VANILLA connection attempt a Channels (s mezerou na konci, která je důležitá pro správnou shodu). Tyto hodnoty odstraňují zprávy, které se často objevují na serverech s aktivním modifikovaným síťovým protokolem.

Závěr

Log Begone skrývá předem známý šum v logovacím souboru Minecraftu pomocí seznamu frází nebo regulárních výrazů. Není to optimalizační mod v klasickém smyslu: vykreslování světa a načítání chunků zůstávají stejné, ale nepřímý přínos ve výkonu a velikosti logu při silném spamu se dosahuje tím, že tisíce opakujících se řádků se prostě nezapisují na disk.

Hodí se pro administrátory serverů se stabilní sadou modů, pro autory modpacků po odstranění obsahu a také pro hráče, kteří chtějí zredukovat logovací soubor na čitelnou velikost pro pozdější diagnostiku skutečných problémů.