Как диагностировать сбои и тормоза сервера FiveM
Найдите причину сбоя или замедления на вашем Linux-сервере FiveM: журналы, память, hitch warnings, resmon, профилировщик и изоляция виновного ресурса.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
У сервера FiveM, который падает или тормозит, часто есть конкретная причина: ресурс, нехватка памяти или перегруженная машина. Это руководство предлагает метод, как её найти: определить симптом, прочитать нужные журналы, выполнить измерения, затем изолировать виновный ресурс.
Предварительные требования
- Сервер, установленный по руководству Создание сервера FiveM: пользователь
fivem, сервисfivem.service, консоль в/home/fivem/fxserver.log - SSH-доступ с
sudoи доступ к txAdmin - Свежая резервная копия, которую нужно сделать командой
sudo /usr/local/sbin/backup-fivem.shперед любыми изменениями
Определение симптома
| Что вы наблюдаете | Основное направление | Раздел для изучения |
|---|---|---|
| Сервер перезапускается сам, все игроки отключены | Остановка процесса или зависание | Шаги 1–3 |
| Сервер больше не запускается или останавливается при загрузке | Ресурс или конфигурация | Шаг 4 |
| Игроки видят рывки, транспорт, который телепортируется | Перегруженный сервер | Шаги 5 и 6 |
| Только у одного игрока низкая частота кадров | Клиентская сторона | Шаг 7 |
| Проблема началась после добавления или обновления | Недавнее изменение | Шаг 8 |
Шаг 1: сохранение журналов
Файл /home/fivem/fxserver.log очищается при каждом запуске сервиса. Скопируйте его, прежде чем что-либо перезапускать:
sudo install -o fivem -g fivem -m 640 /home/fivem/fxserver.log "/home/fivem/fxserver-incident-$(date +%F_%H-%M).log"txAdmin также ведёт собственные журналы с ротацией в /home/fivem/txData/default/logs/:
| Файл | Содержимое |
|---|---|
fxserver.log |
Консоль сервера. В именах старых файлов указана дата |
admin.log |
Действия администраторов и автоматические перезапуски |
server.log |
События в игре: подключения, смерти, сообщения, команды |
Эти файлы содержат данные игроков. Не публикуйте их в исходном виде.
Шаг 2: выяснение причины перезапуска сервера
Найдите решения, принятые txAdmin:
sudo grep -a 'Restarting server' /home/fivem/txData/default/logs/admin.log | tail -n 20| Указанная причина | Значение | Что делать |
|---|---|---|
Server process close detected |
Процесс FXServer остановился | Посмотрите конец консоли и память (шаг 3) |
Server is not responding |
FXServer работает, но не отвечает | Ищите зависание: шаги 5 и 6 |
Server is taking too long to start |
Запуск превышает допустимое время | Перейдите к шагу 4 |
Resource "name" failed to start within the ... time limit |
Этот ресурс блокирует запуск | Проверьте без него (шаг 8) |
Затем прочитайте последние строки консоли перед инцидентом в копии, сделанной на шаге 1:
sudo bash -c 'ls -t /home/fivem/fxserver-incident-*.log | head -n 1 | xargs tail -n 80'Посмотрите также историю сервиса:
sudo systemctl status fivem.service --no-pager
sudo journalctl -u fivem.service --since "2 days ago" --no-pager | tail -n 40Шаг 3: проверка памяти и диска
Когда не хватает памяти, ядро Linux завершает процесс. Найдите его след:
sudo journalctl -k --since "2 days ago" --no-pager | grep -iE 'out of memory|oom-kill|killed process'
free -h
df -h /home /var/lib/mysql- Появляется строка
Out of memory: Killed process: серверу не хватает памяти. Найдите ресурс, потребление которого растёт, затем уменьшите нагрузку или увеличьте память машины. - Диск заполнен на 100 %: освободите место. MariaDB и журналы больше не могут записывать данные.
Чтобы отслеживать память FXServer во времени, выполняйте эту команду в разные моменты. txAdmin и игровой сервер отображаются как два процесса, и больший из них обычно игровой сервер:
ps -u fivem -o pid,pcpu,pmem,rss,etime,args --sort=-rss | cut -c1-110Столбец RSS, который растёт и никогда не уменьшается, при стабильном числе игроков указывает на утечку памяти в ресурсе.
Шаг 4: анализ неудачного запуска
Выведите последние события загрузки:
sudo grep -a -E "Started resource|Could not (find|start) dependency|Couldn't (find|start) resource|can't run|Failed to load script|SCRIPT ERROR" /home/fivem/fxserver.log | tail -n 30| Сообщение | Причина | Решение |
|---|---|---|
Couldn't find resource name. |
Папки не существует или её имя отличается от строки ensure |
Исправьте server.cfg или папку, затем введите refresh |
Couldn't start resource name. |
Запуск не удался | Прочитайте строки непосредственно выше |
Could not find dependency x for resource y. |
Отсутствует ресурс x |
Установите его |
Could not start dependency x for resource y. |
Ресурс x существует, но не запускается |
Сначала разберитесь с x |
Resource 'name' can't run: |
Не выполнено условие, например server needs to be 12913 or higher |
Обновите FXServer |
Failed to load script file. |
Файл отсутствует или недействителен | Переустановите ресурс |
SCRIPT ERROR: |
Ошибка в коде скрипта | Сообщение указывает файл и строку: обновите ресурс или сообщите об ошибке его автору |
При ошибке базы данных обратитесь к руководству Установка и настройка oxmysql на FiveM.
Шаг 5: выявление замедлений сервера
FXServer сообщает о задержках своих внутренних циклов с помощью hitch warnings:
sudo grep -a -c 'hitch warning' /home/fivem/fxserver.log
sudo grep -a 'hitch warning' /home/fivem/fxserver.log | tail -n 20| Сообщение | Срабатывает начиная с | Относится к |
|---|---|---|
server thread hitch warning |
150 мс | Основной цикл, в котором выполняются серверные скрипты |
network thread hitch warning |
150 мс | Сеть |
sync thread hitch warning |
100 мс | Синхронизация OneSync |
Единичное предупреждение при запуске или при перезапуске ресурса не вызывает беспокойства. Регулярные предупреждения во время игры вызывают. Cfx.re чаще всего связывает их с неэффективным ресурсом, например со слишком затратным циклом или медленным SQL-запросом.
Прежде чем обвинять ресурс, убедитесь, что машина не перегружена:
uptime
vmstat 1 10В vmstat посмотрите три столбца:
| Столбец | Высокое значение |
|---|---|
id |
Низкое: процессор почти полностью занят |
wa |
Процессор ожидает диск |
st |
Часть процессорного времени забирает гипервизор |
Затем посмотрите подробности по потокам выполнения, заменив PID номером самого крупного процесса, найденного на шаге 3. Выйдите клавишей q:
top -H -p PIDОдин поток, близкий к 100 %, указывает, что цикл сервера перегружен, даже если у машины есть другие свободные ядра. В этом случае добавление ядер мало поможет: лучше облегчить скрипты. Если wa или st остаются высокими при небольшой нагрузке на сервер, обратитесь в поддержку из вашего личного кабинета, приложив свои измерения.
Проверьте также медленные запросы, о которых сообщает oxmysql:
sudo grep -a 'to execute a query' /home/fivem/fxserver.log | tail -n 20Шаг 6: запись профиля сервера
Встроенный профилировщик показывает, какой ресурс потребляет время. Запустите его в Live Console, пока проблема проявляется, по возможности при подключённых игроках:
profiler record 500
profiler statusДождитесь, пока profiler status покажет Recording: No, затем сохраните результат:
profiler saveJSON server-profile.jsonФайл создаётся в папке сервера, имя которой заканчивается на .base. На сервере скопируйте его в вашу домашнюю папку, заменив FOLDER_NAME:
sudo find /home/fivem/txData -maxdepth 1 -type d -name '*.base'
sudo install -o "$USER" -m 600 /home/fivem/txData/FOLDER_NAME.base/server-profile.json "$HOME/server-profile.json"
sudo rm /home/fivem/txData/FOLDER_NAME.base/server-profile.jsonЗатем получите его на своём компьютере:
scp ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_СЕРВЕРА:server-profile.json .Откройте Google Chrome, затем инструменты разработчика клавишей F12. На вкладке Performance загрузите файл с помощью Load profile. Найдите пики на кривой активности, увеличьте их, затем прочитайте названия самых длительных ресурсов и функций.
Шаг 7: измерение на стороне игрока с помощью resmon
resmon показывает стоимость каждого ресурса на клиенте. Он помогает при падении частоты кадров, но не при задержках сервера.
В игре откройте консоль клавишей F8 и введите:
resmon trueОтсортируйте по CPU msec или Time %, чтобы найти затратные ресурсы, а для памяти смотрите Memory. Введите resmon false, чтобы закрыть.
Если консоль отвечает Access denied for command resmon, режим разработчика на вашем клиенте не включён. Запустите FiveM с аргументом +set moo 31337. В FiveM для GTA V Enhanced этого аргумента больше нет, и сервер должен задать sv_devMode true.
Страница Player Drops в txAdmin дополняет этот анализ: она показывает, покидают ли игроки сервер из-за сбоев своей игры, и с какого момента.
Шаг 8: изоляция виновного ресурса
Начните с того, что менялось недавно. Если ничего не менялось, действуйте делением пополам.
Быстрая проверка на запущенном сервере
Для второстепенного ресурса остановите его в Live Console, затем наблюдайте за предупреждениями около десяти минут:
stop resource_nameЗатем снова запустите его командой ensure resource_name. Не останавливайте так oxmysql, es_extended, qb-core или другой ресурс, от которого зависит множество других: вы вызовете ошибки, не связанные с проблемой.
Поиск делением пополам
Сначала сделайте копию конфигурации, заменив FOLDER_NAME:
sudo -u fivem cp /home/fivem/txData/FOLDER_NAME.base/server.cfg /home/fivem/txData/FOLDER_NAME.base/server.cfg.before-diagnosticЗатем, вне часов пик:
- В CFG Editor отключите половину необязательных ресурсов, добавив
#перед их строкойensure. Оставьте фреймворк и его зависимости. - Перезапустите сервер и попробуйте воспроизвести проблему.
- Если проблема исчезла, она в отключённой половине. Если нет, она в той, что осталась включённой.
- Повторяйте для подозрительной группы, пока не останется один ресурс.
Если несколько ресурсов запускаются одной папкой, например ensure [addons], временно замените эту строку отдельной строкой ensure для каждого из них. Ошибка Could not find dependency во время проверки просто означает, что вы отключили зависимость: включите её снова.
Когда ресурс найден, обновите его, исправьте его конфигурацию или сообщите о проблеме его автору, приложив профиль и журналы. Затем верните исходную конфигурацию и перезапустите сервер из txAdmin:
sudo -u fivem cp /home/fivem/txData/FOLDER_NAME.base/server.cfg.before-diagnostic /home/fivem/txData/FOLDER_NAME.base/server.cfgОбращение за помощью
По вопросу ресурса обращайтесь к его автору или на форум Cfx.re. Подготовьте:
- сборку FXServer и версию txAdmin, определённые как в руководстве Обновление артефактов FXServer
- момент инцидента и то, что изменилось незадолго до него
- соответствующие строки консоли, профиль и результаты
free -hиvmstat
Cfx.re напоминает, что Linux-версия FXServer — это порт, предлагаемый для удобства: если дефект связан с самим FXServer, его скорее исправят, если он воспроизводится в Windows. Проверьте также, что он сохраняется на последней рекомендуемой версии, прежде чем сообщать о нём.
При возникновении проблем во время диагностики
profiler saveJSON возвращает Invalid path
Используйте простое имя файла, без папки, и убедитесь, что пользователь fivem может записывать в папку сервера.
A recording is already taking place
Запись уже идёт. Дождитесь её окончания с помощью profiler status или остановите её командой profiler record stop.
Файл fxserver.log пуст
Сервис только что перезапустился. Используйте /home/fivem/txData/default/logs/fxserver.log, а также файлы с датой в той же папке.
Сервер перезапускается по кругу во время проверок
Остановите его командой sudo systemctl stop fivem.service, верните server.cfg.before-diagnostic на место командой, приведённой выше, затем запустите сервис командой sudo systemctl start fivem.service.