Як читати серверні логи та звіти про падіння
Знайдіть у лозі ігрового сервера той рядок, що має значення: рівні логування, стек-трейси, правило першої помилки та де в панелі лежать логи й звіти про падіння.
4 хв читання · Оновлено 21 жовт. 2026 р. · Автор: GuavaHost Team
Коли сервер падає або відмовляється запускатися, причина майже завжди записана в його лозі. Логи виглядають страшно, але вам рідко потрібно розуміти все: вам потрібно знайти один рядок. Цей гайд показує, як читати рядок лога, що означають рівні, як читати стек-трейс і де в панелі лежать логи та звіти про падіння.
Будова рядка лога
Ось типовий рядок із сервера Minecraft:
[14:02:11] [Server thread/INFO]: Done (8.412s)! For help, type "help"
[14:02:11]це час. Це годинник сервера, який може не збігатися з вашим часовим поясом.Server threadце та частина програми, яка це написала. Server thread це головний ігровий цикл.INFOце рівень: наскільки серйозний цей рядок.- Усе після двокрапки це повідомлення.
Інші ігри форматують рядки інакше, але майже всі десь включають час, рівень і повідомлення.
Рівні логування
| Рівень | Що означає | Чи варто хвилюватися? |
|---|---|---|
| DEBUG або TRACE | Дрібні деталі для розробників | Зазвичай приховані; ігноруйте |
| INFO | Звичайна активність: запуск, входи, збереження | Ні |
| WARN | Щось не так, але сервер працює далі | Іноді; багато попереджень це безневинний шум |
| ERROR | Щось не вдалося | Так, якщо воно збігається з вашою проблемою |
| FATAL або SEVERE | Сервер не може продовжувати | Так, це зазвичай і є саме падіння |
Не ганяйтеся за кожним попередженням. Безліч здорових серверів виводять ті самі безневинні попередження при кожному запуску. Зосередьтеся на помилках, які трапляються тоді, коли трапляється ваша проблема.
Правило першої помилки
Одна справжня проблема часто тягне за собою купу помилок після неї, бо інші частини сервера спотикаються об перший збій. Остання помилка на екрані це зазвичай симптом. Перша помилка після останнього нормального рядка це зазвичай причина.
- Знайдіть останній рядок, де все виглядало нормально.
- Читайте вниз до першого
ERROR,ExceptionабоFATAL. - Виправте саме це, перезапустіть і читайте знову. Якщо сервер тепер проходить далі, перш ніж упасти, ви рухаєтеся вперед.
Як читати стек-трейс
Стек-трейс це список кроків, які виконувала програма, коли зламалася. Ось поширений приклад із сервера Minecraft з плагінами:
[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
Як це читати:
- Перший рядок каже, що зламалося: плагін ExampleShop не зміг запуститися.
- Тип винятку каже, чому:
NoClassDefFoundErrorозначає, що йому потрібен був код, якого немає. - Рядки
atпоказують, де. Шукайте назву, яку ви знаєте, наприклад назву самого плагіна, а не внутрішності гри. Caused byце корінь. Коли в трейсі їх кілька, останнійCaused byзазвичай і є справжньою причиною. Тут бракує класу з Vault, тож виправлення це встановити плагін Vault, від якого залежить цей магазин.
Поширені помилки та що вони зазвичай означають
| Ви бачите | Зазвичай означає |
|---|---|
NoClassDefFoundError, ClassNotFoundException | Бракує залежності, або плагін чи мод від іншої версії |
NoSuchMethodError | Щось зроблене під іншу версію гри |
OutOfMemoryError | Серверу забракло RAM |
FAILED TO BIND TO PORT або Address already in use | Порт зайнятий, часто другою копією, яка ще працює |
found character '\t' that cannot start any token | Табуляція у YAML-конфігурації; YAML допускає лише пробіли |
NullPointerException | Баг або значення в конфігурації, якого немає чи яке написане з помилкою |
Звіти про падіння
Деякі ігри при падінні пишуть окремий, детальніший звіт.
- Minecraft зберігає їх у теці
crash-reports, з датою й часом у назві. Ближче до початку ви знайдете рядокDescriptionі виняток. Сервери з модами перелічують усі завантажені моди, а звіти Forge і NeoForge часто вказують на підозрюваний мод. - Падіння Java, яке кладе саму Java, залишає файл
hs_err_pid(з номером далі) у головній теці сервера. Такі зазвичай вказують на пам'ять або нативну бібліотеку, а не на плагін.
Де в панелі лежать логи
Вкладка Console показує живий вивід. Вона тримає лише свіжі рядки, тож для чогось старішого відкрийте файли логів у вкладці Files або завантажте їх через SFTP.
| Гра | Де шукати |
|---|---|
| Minecraft Java | logs/latest.log; старіші логи це файли .log.gz у logs (завантажте й розпакуйте); падіння в crash-reports |
| Valheim з BepInEx | BepInEx/LogOutput.log |
| ARK: Survival Evolved і Ascended | ShooterGame/Saved/Logs/ShooterGame.log |
| Don't Starve Together | server_log.txt усередині DoNotStarveTogether/config/server/Master і .../Caves, по одному на шард |
| Enshrouded | Тека, задана в logDirectory у enshrouded_server.json, типово logs |
| Інші ігри | Те, що вивела Console; також шукайте теку logs або Logs чи файли, що закінчуються на .log |
Коли панель повідомляє про падіння
Якщо процес сервера раптово зупиняється, панель може вивести власне повідомлення про те, що сервер упав, разом з кодом виходу. Кілька варті знання:
- 0: нормальна зупинка.
- 1: гра завершилася через помилку; читайте рядки трохи вище.
- 137: процес примусово вбили, зазвичай за перевищення ліміту пам'яті. Дивіться ознаки того, що серверу бракує RAM.
- 139: нативне падіння всередині самої гри.
Пошук у довгому лозі
- Завантажте лог і відкрийте його в текстовому редакторі.
- Скористайтеся пошуком (Ctrl+F або Cmd+F на Mac) по
ERROR, потімException, потімCaused by. - Пошукайте назву останнього плагіна чи мода, який ви додали.
- Зіставте часові позначки з моментом, коли сталася проблема.
Як просити допомоги з логом
Скопіюйте від останнього нормального рядка до кінця першої помилки й вставте це як текст, а не як скриншот. Перед тим як десь ним поділитися, приберіть паролі, токени й усе приватне. Потім приносьте це в наш Discord, де команда прочитає його разом з вами. Саме про проблеми із запуском дивіться сервер застряг на запуску.
Усе ще не виходить? Заходьте до нашого Discord на discord.gg/GuavaHost і команда вам допоможе.
- logs
- crash report
- stack trace
- console
- troubleshooting
- errors
Усе ще потрібна допомога? Наша команда онлайн 24/7 і готова відповісти на запитання.