StandardOutput: как служба systemd пишет журнал в файл
По умолчанию всё, что служба выводит на экран, попадает в журнал systemd — его читают командой journalctl. Чтобы вывод шёл в отдельный файл, добавьте в службу строку StandardOutput=append: с путём к файлу. Папку для файла создайте заранее.
Содержание 10
Что сделать прямо сейчас
Пример — служба myapp (как её создать) будет писать в файл /var/log/myapp/app.log.
- Подключитесь к серверу по SSH (как подключиться).
- Создайте папку:
sudo mkdir -p /var/log/myapp. Файл systemd создаст сам, а папку — нет. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. - Откройте дополнение к службе:
sudo systemctl edit myapp(как работает systemctl edit). - Откроется редактор — в Ubuntu это nano. Между строками
### Anything between here…и### Edits below this comment will be discardedвпишите:
[Service]
StandardOutput=append:/var/log/myapp/app.log- Сохраните — Ctrl+O и Enter, выйдите — Ctrl+X.
- Перезапустите службу:
sudo systemctl restart myapp. Новые строки действуют с перезапуска. - Проверьте:
sudo tail -f /var/log/myapp/app.log— на экране появятся записи программы. Выйти — Ctrl+C (как смотреть файлы). - Чтобы файл не рос без конца, настройте для него logrotate со строкой
copytruncate— пример настройки.
Ошибки программы тоже попадут в этот файл: строка StandardError= по умолчанию берёт то же место, что и StandardOutput=.
Куда служба может писать
| Строка | Куда идёт вывод |
|---|---|
StandardOutput=journal | в журнал systemd — так по умолчанию |
StandardOutput=append:/путь/к/файлу | в файл, новые записи дописываются в конец — подходит для журналов |
StandardOutput=truncate:/путь/к/файлу | в файл, который очищается при каждом запуске службы — остаются записи только с последнего запуска |
StandardOutput=file:/путь/к/файлу | в файл, но запись идёт с начала файла поверх старых строк — для журналов не подходит |
StandardOutput=null | вывод выбрасывается |
Те же значения принимает StandardError= — куда идут сообщения об ошибках.
Ошибки — в отдельный файл или в журнал
Ошибки в отдельный файл:
[Service]
StandardOutput=append:/var/log/myapp/app.log
StandardError=append:/var/log/myapp/error.logВывод программы — в файл, ошибки — в журнал systemd:
[Service]
StandardOutput=append:/var/log/myapp/app.log
StandardError=journalТогда ошибки покажет команда journalctl -u myapp (команда journalctl).
Где теперь искать записи
Когда вывод идёт в файл, journalctl -u myapp показывает только сообщения самого systemd: что служба запущена, остановлена или упала. Всё, что выводит программа, — в файле.
| Что посмотреть | Команда |
|---|---|
| последние 50 строк | sudo tail -n 50 /var/log/myapp/app.log |
| новые строки по мере появления | sudo tail -f /var/log/myapp/app.log |
| строки со словом error | sudo grep -i error /var/log/myapp/app.log |
| какие строки действуют в службе | systemctl cat myapp |
Файл создаётся с владельцем root и правами 644: читать его может любой пользователь сервера, менять — только root. Systemd открывает файл до того, как переключиться на пользователя из строки User=, поэтому программе, запущенной от другого пользователя, права на запись в папку не нужны.
Почему append:, а не file:
logrotate со строкой copytruncate копирует файл и обнуляет его. При append: следующая запись ложится в конец файла, то есть с начала уже пустого файла. При file: и truncate: программа продолжит писать с прежнего места: справка systemd предупреждает, что промежуток заполнится нулевыми байтами, а размер файла сразу вернётся к прежнему.
Скрипт пишет в /dev/stderr
Если служба — скрипт bash, а вывод идёт в журнал, строка echo "текст" > /dev/stderr не сработает: в этом случае вывод службы — не файл и не канал, и заново открыть его нельзя. Справка systemd советует писать так:
echo "текст" >&2Как проверить
| Что проверить | Команда |
|---|---|
| какие строки действуют | systemctl cat myapp — ваше дополнение в конце вывода |
| служба работает | systemctl status myapp — строка Active: active (running) |
| файл есть и растёт | ls -l /var/log/myapp/ |
Ошибки и как их исправить
| Что видите | Что делать |
|---|---|
status=209/STDOUT в systemctl status myapp | systemd не смог открыть файл для вывода. В journalctl -u myapp будет строка Failed to set up standard output: …. Создайте папку: sudo mkdir -p /var/log/myapp, проверьте путь на опечатки |
status=222/STDERR | то же для StandardError=: проверьте папку и путь в этой строке |
| файл пустой, а служба работает | выполните systemctl cat myapp — есть ли строка StandardOutput=; перезапустите службу. Программа на Python может копить вывод и писать его в файл порциями: добавьте в [Service] строку Environment=PYTHONUNBUFFERED=1 — переменные окружения |
journalctl -u myapp не показывает записей программы | так и должно быть: вывод идёт в файл. Ошибки можно оставить в журнале строкой StandardError=journal |
| программа пишет журнал сама, в свой файл | StandardOutput= касается только вывода на экран. Файлы, которые программа открывает сама, задаются в её собственных настройках |
| файл занял много места | logrotate со строкой copytruncate; если диск уже полон — No space left on device |
Источники
- Справка systemd.exec(5) в Ubuntu 24.04 — на английском: StandardOutput=, StandardError=, значения journal, append:, truncate:, file:, null; нулевые байты при обнулении файла; совет писать
>&2. - Исходный код systemd 255: exec-invoke.c — файл открывается на дозапись или с очисткой, создаётся с правами 0666 за вычетом umask; вывод настраивается до смены пользователя; сообщение Failed to set up standard output.
- Исходный код systemd 255: exit-status.h и exit-status.c — коды 209/STDOUT и 222/STDERR.
- Документация Python: ключ -u и PYTHONUNBUFFERED — вывод без накопления.
Справка сверена с systemd 255 — эта версия стоит в Ubuntu 24.04.
Сверено 23 октября 2026 года.
Что почитать дальше
- logrotateкак ограничить размер файла журнала.
- journald.confсколько места займёт журнал systemd.
- Команда journalctlкак читать журнал systemd.
- Настройки systemdвсе настройки служб.