Jak czytać logi serwera i raporty awarii
Znajdź tę jedną ważną linię w logu serwera gry: poziomy logowania, ślady stosu, zasada pierwszego błędu oraz gdzie w panelu leżą logi i raporty awarii.
4 min czytania · Aktualizacja: 21 paź 2026 · Autor: GuavaHost Team
Kiedy serwer się wywala albo odmawia uruchomienia, przyczyna jest prawie zawsze zapisana w jego logu. Logi wyglądają onieśmielająco, ale rzadko musisz zrozumieć całość: musisz znaleźć jedną linię. Ten przewodnik pokazuje, jak czytać linię logu, co znaczą poziomy, jak czytać ślad stosu i gdzie w panelu leżą logi oraz raporty awarii.
Anatomia linii logu
Oto typowa linia z serwera Minecraft:
[14:02:11] [Server thread/INFO]: Done (8.412s)! For help, type "help"
[14:02:11]to godzina. To zegar serwera, który może nie zgadzać się z Twoją strefą czasową.Server threadmówi, która część programu to zapisała. Wątek serwera to główna pętla gry.INFOto poziom: jak poważna jest ta linia.- Wszystko po dwukropku to treść komunikatu.
Inne gry formatują linie inaczej, ale prawie wszystkie zawierają gdzieś godzinę, poziom i komunikat.
Poziomy logowania
| Poziom | Znaczenie | Czy się przejmować? |
|---|---|---|
| DEBUG albo TRACE | Drobne szczegóły dla programistów | Zwykle ukryte, ignoruj |
| INFO | Normalna aktywność: start, wejścia graczy, zapisy | Nie |
| WARN | Coś jest nie tak, ale serwer działa dalej | Czasem, wiele ostrzeżeń to nieszkodliwy szum |
| ERROR | Coś się nie udało | Tak, jeśli pokrywa się z Twoim problemem |
| FATAL albo SEVERE | Serwer nie może kontynuować | Tak, to zwykle sama awaria |
Nie goń za każdym ostrzeżeniem. Masa zdrowych serwerów wypisuje te same nieszkodliwe ostrzeżenia przy każdym starcie. Skup się na błędach, które pojawiają się wtedy, gdy pojawia się Twój problem.
Zasada pierwszego błędu
Jeden prawdziwy problem często powoduje za sobą stos błędów, gdy inne części serwera potykają się o pierwszą awarię. Ostatni błąd na ekranie jest zwykle objawem. Pierwszy błąd po ostatniej wyglądającej normalnie linii jest zwykle przyczyną.
- Znajdź ostatnią linię, w której wszystko wyglądało normalnie.
- Czytaj w dół do pierwszego
ERROR,ExceptionalboFATAL. - Napraw ten jeden, zrestartuj i przeczytaj jeszcze raz. Jeśli serwer dochodzi teraz dalej przed awarią, robisz postęp.
Czytanie śladu stosu
Ślad stosu to lista kroków, które program wykonywał w momencie awarii. Oto częsty przykład z serwera Minecraft z wtyczkami:
[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 to czytać:
- Pierwsza linia mówi, co zawiodło: wtyczka ExampleShop nie mogła się uruchomić.
- Typ wyjątku mówi, dlaczego:
NoClassDefFoundErroroznacza, że potrzebowała kodu, którego nie ma. - Linie
atpokazują gdzie. Szukaj nazwy, którą rozpoznajesz, na przykład nazwy samej wtyczki, a nie wnętrzności gry. Caused byto korzeń. Gdy ślad ma kilka takich wpisów, ostatniCaused byjest zwykle prawdziwą przyczyną. Tutaj brakuje klasy z Vault, więc rozwiązaniem jest zainstalowanie wtyczki Vault, od której zależy ten sklep.
Częste błędy i co zwykle oznaczają
| Widzisz | Zwykle oznacza |
|---|---|
NoClassDefFoundError, ClassNotFoundException | Brakującą zależność albo wtyczkę lub mod pod inną wersję |
NoSuchMethodError | Coś zbudowanego pod inną wersję gry |
OutOfMemoryError | Serwerowi skończył się RAM |
FAILED TO BIND TO PORT albo Address already in use | Port jest zajęty, często przez drugą wciąż działającą kopię |
found character '\t' that cannot start any token | Tabulator w pliku konfiguracyjnym YAML, YAML dopuszcza tylko spacje |
NullPointerException | Błąd w kodzie albo brakującą czy błędnie zapisaną wartość w konfiguracji |
Raporty awarii
Część gier zapisuje przy awarii osobny, bardziej szczegółowy raport.
- Minecraft zapisuje je w folderze
crash-reports, nazwane datą i godziną. Blisko góry znajdziesz linięDescriptionoraz wyjątek. Serwery z modami wypisują każdy wczytany mod, a raporty Forge i NeoForge często wskazują podejrzany mod. - Awaria Javy, która kładzie samą Javę, zostawia plik
hs_err_pid(z numerem na końcu) w głównym folderze serwera. Takie zwykle wskazują na pamięć albo bibliotekę natywną, a nie na wtyczkę.
Gdzie w panelu leżą logi
Zakładka Console (konsola) pokazuje bieżące wyjście. Trzyma tylko ostatnie linie, więc po cokolwiek starszego otwórz pliki logów w zakładce Files (pliki) albo pobierz je przez SFTP.
| Gra | Gdzie szukać |
|---|---|
| Minecraft Java | logs/latest.log, starsze logi to pliki .log.gz w logs (pobierz i rozpakuj), awarie w crash-reports |
| Valheim z BepInEx | BepInEx/LogOutput.log |
| ARK: Survival Evolved i Ascended | ShooterGame/Saved/Logs/ShooterGame.log |
| Don't Starve Together | server_log.txt w DoNotStarveTogether/config/server/Master oraz .../Caves, po jednym na fragment |
| Enshrouded | Folder ustawiony przez logDirectory w enshrouded_server.json, domyślnie logs |
| Inne gry | Cokolwiek wypisała konsola, poszukaj też folderu logs albo Logs oraz plików z końcówką .log |
Kiedy panel zgłasza awarię
Jeśli proces serwera zatrzyma się nieoczekiwanie, panel może wypisać własny komunikat o awarii serwera wraz z kodem wyjścia. Kilka wartych zapamiętania:
- 0: normalne zatrzymanie.
- 1: gra wyszła z powodu błędu, przeczytaj linie bezpośrednio powyżej.
- 137: proces został przymusowo zabity, zwykle za przekroczenie limitu pamięci. Zobacz objawy, że serwerowi kończy się RAM.
- 139: natywna awaria w samej grze.
Szukanie w długim logu
- Pobierz log i otwórz go w edytorze tekstu.
- Użyj wyszukiwania (Ctrl+F albo Cmd+F na Macu) dla
ERROR, potemException, potemCaused by. - Poszukaj nazwy ostatniej dodanej przez Ciebie wtyczki albo moda.
- Dopasuj znaczniki czasu do momentu, w którym pojawił się problem.
Proszenie o pomoc z logiem
Skopiuj fragment od ostatniej normalnej linii do końca pierwszego błędu i wklej go jako tekst, a nie zrzut ekranu. Przed udostępnieniem gdziekolwiek usuń hasła, tokeny i wszystko prywatne. Potem przynieś to na nasz Discord, gdzie zespół przeczyta to razem z Tobą. W sprawie problemów z uruchamianiem zobacz serwer zatrzymany na starcie.
Nadal masz problem? Wpadnij na nasz Discord pod adresem discord.gg/GuavaHost, a zespół Ci pomoże.
- logs
- crash report
- stack trace
- console
- troubleshooting
- errors
Nadal potrzebujesz pomocy? Nasz zespół jest online 24/7 i odpowie na Twoje pytania.