Справочник командной строки
Юнит systemd упал: как сузить причину через journalctl -u
Код 203/EXEC значит, что systemd не смог запустить файл, 217/USER — нет пользователя из User=. Три команды и фильтры journalctl, которые находят причину падения юнита за пару минут.
При падении юнита причина почти всегда видна в трёх местах: systemctl show -p ExecMainStatus -p Result даёт код выхода и итог, journalctl -u имя -b -p err показывает только ошибки текущей загрузки, а код 203/EXEC означает, что systemd не смог запустить исполняемый файл — из-за пути, прав или интерпретатора в первой строке. Эти три проверки сужают причину быстрее, чем чтение журнала целиком, который на загруженной машине содержит десятки тысяч строк.
Первые три команды
systemctl status имя --no-pager -l показывает состояние, последние строки журнала и код завершения главного процесса. systemctl show имя -p ExecMainStatus -p ExecMainCode -p Result -p NRestarts выдаёт те же данные машинно-читаемым списком, что удобно при разборе инцидента из скрипта. Третья команда — journalctl -u имя -b -p err --no-pager -n 50: только сообщения уровня err и выше в пределах текущей загрузки.
Уровень -p err — это порог, а не точное совпадение: в вывод попадут emerg, alert, crit и err. Если нужно увидеть предупреждения, поднимите порог до warning; если журнал шумный, опустите до crit. Сортировка всегда хронологическая, поэтому последняя строка перед остановкой обычно и есть причина.
Что означают коды 203 и 217
Строка «Main process exited, code=exited, status=203/EXEC» означает, что процесс не был создан. Типичные причины: бинарника нет по указанному пути, он собран под другую архитектуру, отсутствует динамический загрузчик, а в shebang стоит интерпретатор, которого нет в системе. Отдельный случай — файл с переводами строк CRLF: ядро читает #!/bin/bash\r и ищет программу с именем bash\r.
Код 217/USER появляется, когда в User= указан несуществующий пользователь. Код 200/CHDIR — когда нет каталога из WorkingDirectory=. Код 226/NAMESPACE указывает на конфликт с ограничениями sandbox: например, ReadWritePaths= ссылается на путь, которого нет, или PrivateTmp= мешает программе, ожидающей общий /tmp.
Фильтры журнала, которые экономят время
journalctl -u имя --since "30 min ago" --until "5 min ago" ограничивает окно по времени; интервал принимает и абсолютные даты. -b -1 переключает на предыдущую загрузку, а journalctl --list-boots показывает их список с идентификаторами. Без этого легко искать ошибку в журнале текущей загрузки, тогда как юнит падал до перезагрузки.
Формат вывода тоже влияет на читаемость. -o cat оставляет только сообщения без префиксов, -o short-precise добавляет микросекунды, -o json-pretty отдаёт все поля, включая _PID, _SYSTEMD_UNIT и _COMM. Для юнитов пользовательского менеджера нужен флаг --user; без него -u ничего не найдёт, потому что запись лежит в другом экземпляре journald.
Почему журнал пуст
Если journalctl -u имя не выдаёт ни строки, проверьте хранилище. При Storage=volatile записи лежат в /run/log/journal и исчезают после перезагрузки; постоянный журнал включается параметром Storage=persistent и каталогом /var/log/journal. В контейнере journald может отсутствовать вовсе, и тогда вывод юнита уходит в общий поток хоста или в никуда.
Второй вариант — ограничение частоты. systemd отбрасывает лавину одинаковых сообщений и печатает «Suppressed N messages due to rate limit». Именно подавленная строка часто содержит настоящую причину. Параметры RateLimitIntervalSec и RateLimitBurst в journald.conf управляют этим поведением, но менять их стоит только на время разбора.
Третий вариант — юнит сам закрывает вывод: StandardOutput=null или StandardError=null в блоке [Service]. Проверяется одной командой systemctl show имя -p StandardOutput -p StandardError.
Сверка конфигурации перед повторным запуском
systemctl cat имя показывает все файлы юнита по порядку с учётом drop-in каталогов, а systemctl show имя -p Environment -p ExecStart — фактические значения после подстановок. systemd-analyze verify /etc/systemd/system/имя.service проверяет синтаксис и предупреждает о неизвестных директивах, которые systemd молча игнорирует.
После правки файла нужен systemctl daemon-reload: без него система продолжает работать со старой копией. Если юнит ушёл в состояние failed и счётчик запусков исчерпан, появляется сообщение «start request repeated too quickly»; перед новой попыткой выполните systemctl reset-failed имя, иначе запуск будет отклонён без объяснений.
Полезно также посмотреть зависимости: systemctl list-dependencies имя показывает, что должно быть поднято раньше. Юнит, который падает через две секунды после старта, часто ждёт сеть или точку монтирования, объявленную в After=, но не в Requires=, и стартует слишком рано.
Если юнит пишет через собственный идентификатор, полезен фильтр -t: journalctl -t имя -b находит записи по полю SYSLOG_IDENTIFIER, даже когда они не привязаны к юниту напрямую. В systemd 237 и новее есть --grep=шаблон, который ищет по тексту сообщения без выгрузки в grep; шаблон при этом является регулярным выражением, а не подстрокой.
Ещё одно поле, которое стоит смотреть при повторяющихся падениях, — счётчик перезапусков. systemctl show имя -p NRestarts -p StartLimitBurst -p StartLimitIntervalUSec показывает, сколько попыток уже сделано и когда система перестанет их принимать. Юнит с Restart=always без ограничения способен за минуту создать тысячи записей и скрыть первую, самую информативную ошибку.