Jak čtu logy serveru a crash reporty
Najdi v logu herního serveru ten řádek, na kterém záleží: úrovně logování, stack trace, pravidlo první chyby a kde v panelu žijí logy a crash reporty.
4 min čtení · Aktualizováno 21. 10. 2026 · Autor: GuavaHost Team
Když server spadne nebo se odmítá spustit, důvod je téměř vždycky napsaný v jeho logu. Logy působí zastrašujícím dojmem, ale málokdy potřebuješ rozumět všemu: potřebuješ najít jeden řádek. Tento návod ti ukáže, jak přečíst řádek logu, co znamenají úrovně, jak se čte stack trace a kde v panelu žijí logy a crash reporty.
Anatomie řádku logu
Tady je typický řádek z minecraftového serveru:
[14:02:11] [Server thread/INFO]: Done (8.412s)! For help, type "help"
[14:02:11]je čas. Je to hodiny serveru, které nemusí odpovídat tvé časové zóně.Server threadříká, která část programu to napsala. Server thread je hlavní herní smyčka.INFOje úroveň: jak vážný ten řádek je.- Všechno za dvojtečkou je zpráva.
Jiné hry formátují řádky jinak, ale skoro všechny někde obsahují čas, úroveň a zprávu.
Úrovně logování
| Úroveň | Význam | Máš se bát? |
|---|---|---|
| DEBUG nebo TRACE | Detaily pro vývojáře | Obvykle skryté, ignoruj |
| INFO | Normální provoz: start, připojení, ukládání | Ne |
| WARN | Něco není v pořádku, ale server jede dál | Někdy, hodně varování je neškodný šum |
| ERROR | Něco selhalo | Ano, pokud to časově sedí s tvým problémem |
| FATAL nebo SEVERE | Server nemůže pokračovat | Ano, tohle je obvykle samotný pád |
Nehoň se za každým varováním. Hromada zdravých serverů vypisuje stejná neškodná varování při každém startu. Zaměř se na chyby, které nastanou ve chvíli, kdy nastane tvůj problém.
Pravidlo první chyby
Jeden skutečný problém po sobě často vyvolá hromadu dalších chyb, jak další části serveru zakopnou o to první selhání. Poslední chyba na obrazovce je obvykle příznak. První chyba za posledním normálně vypadajícím řádkem je obvykle příčina.
- Najdi poslední řádek, kde to ještě vypadalo normálně.
- Čti dolů až k první
ERROR,ExceptionneboFATAL. - Oprav tuhle jednu, restartuj a čti znovu. Jestli se server dostane dál, než selže, děláš pokrok.
Jak se čte stack trace
Stack trace je seznam kroků, které program dělal ve chvíli, kdy selhal. Tady je běžný příklad z minecraftového serveru s pluginy:
[12:40:03 ERROR]: Error occurred while enabling ExampleShop v2.1 (Is it up to date?)
java.lang.NoClassDefFoundError: net/milkbowl/vault/economy/Economy
at com.example.shop.ShopPlugin.onEnable(ShopPlugin.java:57)
...
Caused by: java.lang.ClassNotFoundException: net.milkbowl.vault.economy.Economy
Jak ho čteš:
- První řádek říká, co selhalo: plugin ExampleShop se nedokázal spustit.
- Typ výjimky říká proč:
NoClassDefFoundErrorznamená, že potřeboval kód, který tam není. - Řádky
atukazují kde. Hledej jméno, které poznáváš, třeba jméno samotného pluginu, a ne vnitřnosti hry. Caused byje ten kořen. Když má trace několik takových řádků, to posledníCaused byje obvykle skutečný důvod. Tady chybí třída z Vaultu, takže oprava je nainstalovat plugin Vault, na kterém tenhle shop závisí.
Běžné chyby a co obvykle znamenají
| Co vidíš | Obvykle to znamená |
|---|---|
NoClassDefFoundError, ClassNotFoundException | Chybějící závislost, nebo plugin či mod pro jinou verzi |
NoSuchMethodError | Něco postavené pro jinou verzi hry |
OutOfMemoryError | Serveru došla RAM |
FAILED TO BIND TO PORT nebo Address already in use | Port je obsazený, často druhou kopií, která ještě běží |
found character '\t' that cannot start any token | Tabulátor v konfiguračním souboru YAML, YAML dovoluje jen mezery |
NullPointerException | Chyba v kódu, nebo hodnota v konfiguraci, která chybí nebo je špatně napsaná |
Crash reporty
Některé hry při pádu zapíšou samostatný, podrobnější report.
- Minecraft je ukládá do složky
crash-reports, pojmenované datem a časem. Blízko začátku najdeš řádekDescriptiona výjimku. Moddované servery vypíšou každý nahraný mod a reporty z Forge a NeoForge často ukážou na mod, který je v podezření. - Pád Javy, který položí samotnou Javu, nechá v hlavní složce serveru soubor
hs_err_pid(za nímž následuje číslo). Ty obvykle ukazují na paměť nebo na nativní knihovnu, ne na plugin.
Kde v panelu žijí logy
Karta Console (konzole) ukazuje živý výstup. Drží jen nedávné řádky, takže na cokoli starší otevři soubory logů na kartě Files (soubory) nebo si je stáhni přes SFTP.
| Hra | Kde hledat |
|---|---|
| Minecraft Java | logs/latest.log, starší logy jsou soubory .log.gz ve logs (stáhni a rozbal), pády v crash-reports |
| Valheim s BepInEx | BepInEx/LogOutput.log |
| ARK: Survival Evolved a Ascended | ShooterGame/Saved/Logs/ShooterGame.log |
| Don't Starve Together | server_log.txt uvnitř DoNotStarveTogether/config/server/Master a .../Caves, jeden na každý shard |
| Enshrouded | Složka nastavená v logDirectory v enshrouded_server.json, výchozí je logs |
| Ostatní hry | Cokoli vypsala konzole, a hledej taky složku logs nebo Logs nebo soubory končící na .log |
Když pád nahlásí panel
Pokud se serverový proces nečekaně zastaví, panel může vypsat vlastní zprávu o tom, že server spadl, spolu s návratovým kódem. Několik, které je dobré znát:
- 0: normální zastavení.
- 1: hra skončila kvůli chybě, přečti si řádky hned nad tím.
- 137: proces byl násilně ukončen, obvykle za překročení limitu paměti. Viz příznaky, že serveru dochází RAM.
- 139: nativní pád uvnitř samotné hry.
Jak prohledat dlouhý log
- Stáhni si log a otevři ho v textovém editoru.
- Použij Najít (Ctrl+F, nebo Cmd+F na Macu) na
ERROR, potom naExceptiona potom naCaused by. - Vyhledej jméno posledního pluginu nebo modu, který jsi přidal.
- Srovnej časové značky s tím, kdy problém nastal.
Jak požádat o pomoc s logem
Zkopíruj úsek od posledního normálního řádku až na konec první chyby a vlož ho jako text, ne jako screenshot. Než ho někam nasdílíš, odstraň hesla, tokeny a všechno soukromé. Potom ho přines na náš Discord, kde si ho s tebou tým přečte. Konkrétně k problémům se startem viz server zůstal na starting.
Pořád se nedaří? Přijď na náš Discord na discord.gg/GuavaHost a tým ti pomůže.
- logs
- crash report
- stack trace
- console
- troubleshooting
- errors
Pořád potřebuješ pomoct? Náš tým je online 24/7 a odpoví ti na dotazy.