Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Logy

Log je soubor, který obsahuje výstup serveru. V něm se nachází mnoho informací, z kterých lze (většinou) vyčíst příčinu a řešení různých problémů.

Jak poslat log

Obsah logu otevřete, jeho veškerý obsah klávesovou zkratkou Ctrl + A označte, poté klávesovou zkratkou Ctrl + C zkopírujte, zkopírovaný obsah vložte na nějaký pastebin (např. https://mclo.gs) a uložte (odešlete). Po odeslání logu na pastebin Vám pastebin vygeneruje odkaz, který můžete ostatním nasdílet.

Obvykle chcete sdílet poslední log, který se u většiny platforem bude nacházet v /logs/latest.log.

Vždy zašlete log relevantní k času problému, tzn. pokud se problém vyskytl při posledním startu serveru, neposílejte log starý několik dní, ale poslední log (což bude u většiny platforem /logs/latest.log).

Log vždy sdílejte celý, neodebírejte “nepodstatné informace”, nesdílejte úryvky viz zde.

Pokud se server ani nepokusí zapnout, tím pádem se log nevytvoří, zašlete výstup z konzole (terminalu). Pokud se konzole při zapnutí ihned uzavře, tím pádem nemáte čas výstup zkopírovat, na nový poslední řádek startovací skriptu (něco.bat/něco.sh) na operačním systému Windows přidejte pause, na Linuxu/macOS read -p "Stiskněte libovolnou klávesu pro ukončení".

Kde se log nachází

U klasických platforem a Velocity se logy nachází ve složce /logs/, na BungeeCordu/Waterfallu v souboru proxy.log.0.

U velmi starých verzí (1.5.2/1.6.4) se log nachází v kořenové složce serveru v souboru server.log.

Základní práce s logem

V případě, kdy se potýkáte s problémem týkající se samotného serveru, pluginu, nebo módu, příčina a řešení tohoto problému se dá téměř vždy vyčíst z logu serveru.

Log můžete číst od začátku řádek po řádku, ale to je obvykle zbytečné. V logu můžete v prakticky jakémkoli prohlížeči/textovém editoru vyhledávat v textu pomocí klávesové zkratky Ctrl + F.

Pokud tedy máte obecný problém se serverem, kdy příčinu neznáte (např. server se automaticky vypne), chcete v logu hledat chybové zprávy, tedy zprávy s log levelem error, eventuelně warn, to znamená zprávy obsahující ‘ERROR’ (případně na Forge i ‘FATAL’ a Bungee/Waterfall ‘SEVERE’).

Pokud máte konkrétní problém s pluginem (případně módem; např. se nezapne), chcete hledat zprávy v logu s názvem daného pluginu. Když se tedy nezapne plugin AuctionHouse, v logu chcete hledat zprávy obsahující ‘AuctionHouse’, jak je tomu v příkladu níže.

Pokud nevíte, co různé chyby v logu znamenají, může Vám pomoci tato část.

Pokud obsahu logu i tak nerozumíte a ani Google nepomůže, log nasdílejte a nechte si poradit.

Zpráva v logu může vypadat například následovně:

[18:42:47] [Server thread/ERROR]: [AuctionHouse] Error! No plugin supporting Vault's Economy API was found!

Struktura zprávy logu v příkladu vyše je následující:

  1. časové razítko

První část této zprávy je čas, kdy byla zaznamenána.

  1. zdroj zprávy

Zdroj zprávy označuje, na jakém vlákně byla zpráva zaznamenána. V tomto případě je to ‘Server thread’. Tato informace je většinou zbytečná a pro řešení základních problémů jí nepotřebujete rozumět.

  

  1. log level

Log level označuje závažnost. V tomto případě je log level ERROR, což označuje, že se jedná o chybovou zprávu.

Existující levely jsou následující:

  • info - pouze informační zpráva
  • warn - nemělo by se jednat o závažnou chybu, ale uživatele na něco upozorňuje
  • error - zpráva s log level error znamená, že nastala nějaká chyba

Na Forge se můžete setkat i s ‘FATAL’, na BungeeCord/Waterfallu i se ‘SEVERE’.

  1. název komponenty

Komponenta označuje, z kudy zpráva pochází (čím byla zalogována). V tomto případě se jedná o plugin AuctionHouse. Pokud komponenta chybí, zprávu zalogoval samotný Minecraft server.

  1. zpráva

V tomto případě “Error! No plugin supporting Vault’s Economy API was found!” - popisuje konkrétní zprávu.

Samotný formát log zprávy se může lišit, například nemusí obsahovat hranaté závorky.

Rozdělení logu

Pokud server běží delší dobu, log se po nějakém čase automaticky “usekne” a vytvoří se nový soubor. Pokud v takovém případě zasíláte poslední log, je potřeba přiložit i log předešlý, aby měl člověk, co log čte, všechny potřebné informace.