Поиск
Справочник

StandardOutput: как служба systemd пишет журнал в файл

По умолчанию всё, что служба выводит на экран, попадает в журнал systemd — его читают командой journalctl. Чтобы вывод шёл в отдельный файл, добавьте в службу строку StandardOutput=append: с путём к файлу. Папку для файла создайте заранее.

≈ 6 мин чтения
Содержание 10

Что сделать прямо сейчас

Пример — служба myapp (как её создать) будет писать в файл /var/log/myapp/app.log.

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Создайте папку: sudo mkdir -p /var/log/myapp. Файл systemd создаст сам, а папку — нет. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter.
  3. Откройте дополнение к службе: sudo systemctl edit myapp (как работает systemctl edit).
  4. Откроется редактор — в Ubuntu это nano. Между строками ### Anything between here… и ### Edits below this comment will be discarded впишите:
[Service]
StandardOutput=append:/var/log/myapp/app.log
  1. Сохраните — Ctrl+O и Enter, выйдите — Ctrl+X.
  2. Перезапустите службу: sudo systemctl restart myapp. Новые строки действуют с перезапуска.
  3. Проверьте: sudo tail -f /var/log/myapp/app.log — на экране появятся записи программы. Выйти — Ctrl+C (как смотреть файлы).
  4. Чтобы файл не рос без конца, настройте для него 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
строки со словом errorsudo 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 myappsystemd не смог открыть файл для вывода. В 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 255 — эта версия стоит в Ubuntu 24.04.

Сверено 23 октября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше