Záznamy o chodu serveru najdete v administraci v záložce LOGS a také v souboru /logs/latest.log. Protokoly o pádech serveru (crash reporty) se ukládají do složky /crash-reports/. Základní pravidlo úspěšné diagnostiky zní: hledejte první zaznamenanou chybu v chronologickém pořadí a řádek začínající na Caused by: – právě ten odhaluje skutečnou příčinu, nikoliv poslední zpráva na konci souboru.
#Co budete potřebovat
- Přístup do administrace na manage.mchost.gg.
- Záložku LOGS (rychlý náhled, vyhledávání a stažení) nebo FILES (složky
logsacrash-reports).
#Kde se logy nacházejí
| Soubor | Obsah |
|---|---|
/logs/latest.log |
Záznam aktuálního nebo naposledy proběhlého běhu serveru |
/logs/YYYY-MM-DD-N.log.gz |
Zkomprimované archivy dřívějších relací |
/crash-reports/crash-*.txt |
Podrobný protokol z kritického selhání virtuálního stroje Java (JVM) |
V záložce LOGS máte k dispozici vyhledávací pole Filter logs…, tlačítko Refresh a tlačítko Download pro stažení celého souboru do počítače.
#Úrovně závažnosti zpráv
| Úroveň | Význam |
|---|---|
INFO |
Běžné provozní informace o chodu serveru |
WARN |
Varování – server pokračuje v běhu, ale narazil na drobnou nesrovnalost |
ERROR |
Závažná chyba – obvykle selhalo načtení doplňku nebo konkrétní operace |
FATAL |
Kritická chyba vedoucí k okamžitému zastavení serveru |
Nečtěte log od konce souboru. Poslední řádky obvykle popisují pouze důsledek (např. běžné ukládání světa při vypínání), nikoliv původní příčinu. Hledejte vždy první řádek s označením ERROR odshora.
#Jak správně číst chybový výpis (Stack Trace)
[12:03:41] [Server thread/ERROR]: Could not load 'plugins/StaryPlugin.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError:
pl/example/Main has been compiled by a more recent version of the Java Runtime
at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.java:147)
...
Caused by: java.lang.UnsupportedClassVersionError: pl/example/MainČtěte v následujícím pořadí:
- První řádek s označením
ERROR– popisuje, co přesně selhalo (Could not load 'plugins/StaryPlugin.jar'). - Název souboru v uvozovkách nebo hranatých závorkách – identifikuje viníka.
Caused by:– popisuje skutečný technický důvod. Pokud je v bloku více těchto řádků za sebou, rozhodující je poslední z nich.- Řádky začínající na
at ...představují stopu volání kódu – jsou užitečné především pro vývojáře daného doplňku.
#Typická chybová hlášení a jejich význam
| Hlášení | Příčina |
|---|---|
UnsupportedClassVersionError |
Doplněk vyžaduje novější verzi Javy, než jaká je nastavena |
NoClassDefFoundError |
Chybějící závislost – plugin ke svému běhu potřebuje jiný plugin |
Could not load 'plugins/X.jar' |
Plugin není kompatibilní se serverovým jádrem nebo verzí hry |
Failed to bind to port |
Předchozí instance serveru stále blokuje síťový port |
java.lang.OutOfMemoryError |
Došla přidělená operační paměť RAM |
Failed to load level.dat |
Poškozený nebo nekompletní soubor světa |
Incompatible mod set |
Neshoda seznamu či verzí módů mezi hráčem a serverem |
Can't keep up! Is the server overloaded? |
Server nestíhá zpracovávat herní ticky (TPS drop) – viz Lagy na Minecraft serveru |
#Záznamy o pádech (Crash reports)
Soubor ze složky /crash-reports/ začíná záhlavím ---- Minecraft Crash Report ----. Klíčové jsou tři sekce:
Description:– stručný souhrn chyby v jedné větě.Caused by:– konkrétní vyvolaná výjimka.-- Head --/Stacktrace:– počáteční řádky ukazují cestu k balíčku konkrétního módu (např.at com.example.mod.EntityHandler).
Název balíčku ve stack trace představuje nejrychlejší způsob, jak odhalit konkrétní mód zodpovědný za pád.
Crash report vzniká pouze při tvrdém pádu běhového prostředí JVM. Pokud se server při chybě ukončí spořádaně (graceful shutdown), veškeré informace zůstávají zapsány pouze v souboru latest.log.
#Filtrování záznamů
Vyhledávací pole v záložce LOGS umožňuje rychlé filtrování. Užitečná klíčová slova: ERROR, Caused by, WARN nebo konkrétní název pluginu.
Pokud máte soubor stažený v počítači, můžete v terminálu použít:
grep -n "ERROR" latest.log | head -20
grep -n -A5 "Caused by" latest.log | head -40#Nahlášení problému podpoře
Při zakládání požadavku na zákaznickou podporu vždy přiložte celý soubor latest.log (stažený tlačítkem Download), nikoliv pouze výstřižek obrazovky. Řádek bezprostředně předcházející chybě často obsahuje rozhodující indicii.
#Nejčastější problémy
#V logu je obrovské množství chyb – čím začít?
Vždy začněte od první chyby v chronologickém pořadí. Všechny následující chyby bývají pouhým řetězovým důsledkem toho, že se první komponenta nedokázala načíst.
#Záznam v logu končí uprostřed věty
Proces serveru byl ukončen násilně zvenčí – ověřte, zda nedošlo k použití volby Kill, nebo zda server nenarazil na OutOfMemoryError.
#Složka crash-reports vůbec neexistuje
Nedošlo ke kritickému pádu JVM – server se po chybě vypnul standardní cestou. Prozkoumejte soubor latest.log.
#Soubor latest.log má desítky megabajtů
Některý z pluginů zahlcuje log opakovanými varováními. Stáhněte soubor a vyfiltrujte pouze řádky s ERROR – samotná opakující se varování WARN můžete v této fázi ignorovat.
#Zjistil jsem název problematického módu, jak postupovat dál?
Odstraňte jeho .jar soubor ze složky /mods (případně /plugins), spusťte server a ověřte, zda chyba zmizela. Tím si potvrdíte správnost své diagnózy.