journalctl: шпаргалка по фильтрации логов systemd с готовыми командами | AdminWiki

journalctl: шпаргалка по фильтрации логов systemd с готовыми командами

16 ноября 2026 10 мин. чтения

journalctl читает журнал systemd-journald, поэтому устанавливать ничего не нужно: утилита приходит вместе с systemd. Запуск без опций отдаёт весь журнал, а опции сужают выборку до нужного окна времени, юнита, приоритета или процесса. Основная работа сводится к пяти флагам: -u, -p, --since, --until и -f, плюс -o для формата вывода.

Ниже копируемые команды под конкретные задачи: найти ошибки сервиса, вырезать интервал инцидента, следить за логом в реальном времени, выгрузить журнал в файл и убрать старое, чтобы журнал не занял диск. Синтаксис и набор форматов вывода сверяйте с man journalctl на своём сервере: между версиями systemd отличия есть.

Что даёт journalctl и как быстро найти нужную запись

systemd-journald пишет события в бинарный журнал и сам собирает метаданные записи: юнит, PID, UID, приоритет, загрузку. journalctl читает этот журнал и умеет фильтровать по этим полям, а не только по тексту сообщения. Отсюда главное практическое преимущество: выборка строится по структуре записи, поэтому не зависит от формулировки сообщения и регистра.

Читать системный журнал может не каждый пользователь. По умолчанию обычный пользователь имеет доступ только к своему персональному журналу; чтобы читать системный, его нужно добавить в группу systemd-journal. Члены групп systemd-journal и adm также получают доступ на чтение системного журнала. Если вывод выглядит пустым или урезанным, проверьте своё членство в этих группах.

По умолчанию вывод открывается в постраничном просмотрщике. В скриптах и при перенаправлении в файл добавляйте --no-pager, иначе команда будет ждать интерактивного ввода.

Базовый синтаксис и логика фильтров

Общий вид команды: journalctl [опции] [совпадения по полям]. Фильтры комбинируются по логическому «И», то есть каждый следующий сужает выборку. Порядок опций не важен, важна их согласованность: если запросить окно, в котором сервис не работал, вы получите пустой вывод.

journalctl -u nginx --since '1 hour ago' -p err --no-pager

Здесь три условия сразу: только юнит nginx, только последний час, только ошибки и выше по важности. Такой набор закрывает типовой запрос «что сломалось у сервиса за последний час» без прокрутки тысяч строк.

Минимальный набор, который стоит держать под рукой:

  • journalctl: весь журнал от старых записей к новым.
  • journalctl -u nginx: записи одного юнита (суффикс .service можно опускать).
  • journalctl -p err: ошибки и всё, что важнее.
  • journalctl --since '1 hour ago': окно по времени.
  • journalctl -f: поток в реальном времени.
  • journalctl -o json: машинночитаемый вывод.

Полезные дополнения к базе: -b ограничивает текущей загрузкой, -b -1 показывает предыдущую, -k оставляет только сообщения ядра, -n 100 выводит последние сто строк, -r переворачивает порядок (свежие сверху). Подробный разбор фильтров, хранения и передачи логов на центральный сервер собран в руководстве по journalctl и systemd-journald.

Просмотр логов за период: --since и --until

--since и --until принимают и относительные, и абсолютные значения. Если в --since указано только время, выводятся записи начиная с текущей даты; если указана только дата, время по умолчанию считается равным 00:00:00. Относительные значения удобны при разборе свежего инцидента, абсолютные нужны, когда известны точные метки событий.

journalctl --since 'today'
journalctl --since '1 hour ago' --no-pager
journalctl --since '2026-01-15 10:00:00' --until '2026-01-15 10:30:00' --no-pager

Сценарий с деплоя: релиз выкатили в 10:00, жалобы начались сразу после. Берите окно с запасом до и после, иначе потеряете первую ошибку, которая часто приходит за секунды до заметного сбоя.

journalctl --since '2026-01-15 09:55:00' --until '2026-01-15 10:15:00' -p err --no-pager

Комбинация --since и --until даёт точное окно и защищает от гигантского вывода: забытый --until на нагруженном сервере выдаёт мегабайты текста и тормозит терминал.

Проверяйте часовой пояс. Без явного смещения время трактуется в локальной зоне сервера, и окно сместится, если вы сверяете логи с машиной в UTC. Для сравнения событий с разных хостов приводите вывод к UTC через --utc, а метки пишите в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС.

Фильтрация по юниту, приоритету и PID

Три фильтра, которые убирают основной шум при дебаге: -u по юниту, -p по приоритету, поле _PID по конкретному процессу.

Юнит. Опцию можно указать несколько раз, тогда вывод объединит записи всех перечисленных сервисов:

journalctl -u nginx
journalctl -u nginx -u php-fpm --since '30 min ago' --no-pager

Приоритет. -p принимает одиночный числовой или текстовый уровень журнала (от 0/emerg до 7/debug) либо диапазон. При одиночном значении выводятся записи этого уровня и всё, что важнее (то есть с меньшим кодом). Шкала systemd совпадает с syslog:

УровеньКодЧто попадёт в выборку
emerg0отказ системы, работа продолжается только на аварийном режиме
alert1требуется немедленное вмешательство
crit2критическое состояние подсистемы
err3ошибки выполнения операций
warning4предупреждения, работа продолжается
notice5значимые, но штатные события
info6обычные информационные сообщения
debug7отладочный вывод
journalctl -p err --since today --no-pager
journalctl -p err..warning --since '2 hours ago' --no-pager

Диапазон через две точки задаёт две границы вместо правила «и всё, что важнее»: показываются все сообщения внутри диапазона, включая начальное и конечное значения. Так удобно отсечь info и debug, не теряя предупреждений.

PID. Когда сообщения пишет дочерний процесс, юнит не помогает: у записей будет свой _PID. Возьмите PID из systemd и отфильтруйте по полю:

systemctl show -p MainPID --value nginx
journalctl _PID=1234 --no-pager
journalctl _PID=1234 -p err --since '10 min ago' --no-pager

По той же схеме работают другие поля: _UID для пользователя, _COMM для имени исполняемого файла, -t для syslog-идентификатора. Комбинация -u и -p со окном --since сокращает шум до десятков строк, которые реально читаются глазами.

Режим реального времени и экспорт в файл: -f и -o

-f переводит journalctl в режим слежения: сначала печатается хвост журнала, затем новые записи по мере поступления. Выход по Ctrl+C. Фильтры при этом продолжают работать, что важно при воспроизведении бага.

journalctl -f
journalctl -u nginx -f
journalctl -u app -p err -f --no-pager

Совет по практике: следите за приложением вместе с его ошибками, но не глушите вывод целиком. Если под рукой нет терминала, комбинируйте -f с -n 50, чтобы не выгружать всю историю.

Экспорт. Перенаправление в файл требует --no-pager, иначе в файл попадёт постраничный вывод. Формат выбирайте по цели:

journalctl -u app --since 'today' -o json --no-pager > app.json
journalctl -u app --since '2026-01-15 09:55:00' --until '2026-01-15 10:15:00' -o short-iso --no-pager > app.log
Формат -oКогда использовать
shortчтение глазами, привычный вид с датой и хостом
short-isoметки в ISO 8601, удобно сравнивать с логами других систем
catтолько текст сообщения, минимум служебных полей
jsonзапись сериализуется как один JSON-объект, удобно для jq и анализаторов
verboseвсе поля записи, когда нужно увидеть метаданные целиком
exportбинарный формат сериализации журналов, применяется для передачи журнальных данных по сети

Для выгрузки в тикет берите short-iso: коллега увидит время в однозначном формате. Для автоматической обработки берите json и проверяйте результат командой jq -c . app.json, чтобы убедиться, что файл читается.

grep по выводу работает, но уступает встроенным фильтрам: он ищет подстроку в готовой строке, а journalctl фильтрует по полям записи. Если нужно искать по тексту, добавляйте grep после фильтров, а не вместо них. Как собрать такие логи с нескольких хостов в одну систему, разобрано в материале о централизованном логировании в Linux.

Управление размером журнала и очистка старых записей

Начните с факта, а не с догадки. Команда ниже показывает, сколько занимают активный и архивные файлы журнала:

journalctl --disk-usage
df -h /var

Дальше решайте, что делать: разово почистить или поставить постоянный лимит. Для разовой очистки есть варианты, и разница между ними принципиальна.

journalctl --vacuum-size=500M
journalctl --vacuum-time=7d

--vacuum-size уменьшает журнал до указанного размера, удаляя старые архивные файлы. --vacuum-time удаляет архивные записи старше заданного срока. Важное ограничение: vacuum-time может очищать только архивные логи, поэтому актуальные записи после такой команды могут остаться на месте. Обходной путь — сначала выполнить journalctl --rotate: journald начнёт новый активный файл, а текущий станет архивным и попадёт под vacuum.

Постоянный лимит задаётся в /etc/systemd/journald.conf в секции [Journal]:

[Journal]
SystemMaxUse=2G
RuntimeMaxUse=256M
SystemKeepFree=5G

SystemMaxUse и RuntimeMaxUse ограничивают максимальный объём дискового пространства, который может занимать журнал. SystemKeepFree задаёт верхнюю границу свободного места, которое будет сохраняться на диске, и защищает от ситуации «журнал съел всё». Наличие каталога /var/log/journal определяет режим хранения журнала (persistent), и данные журнала размещаются в /var/log/journal/. Без этого каталога записи живут в /run и пропадают после перезагрузки.

После правки перезапустите службу журнала, чтобы настройки применились, и убедитесь, что она поднялась:

systemctl restart systemd-journald
systemctl status systemd-journald --no-pager

Безопасность важнее экономии диска. Перед vacuum выгрузите окно инцидента в файл через -o json или short-iso, особенно если разбор ещё не закончен. Не удаляйте записи за период, который расследуете. Перезапуск journald не роняет прикладные сервисы, но выполняйте его в окно обслуживания и фиксируйте исходные значения параметров, чтобы откатиться одной правкой.

Проверка результата после очистки и настройки

Проверяйте эффект, а не намерение. Короткий чек-лист после изменений:

  1. journalctl --disk-usage: сравните с замером до очистки, объём должен снизиться.
  2. journalctl -n 20 --no-pager: новые записи продолжают поступать, журнал пишется.
  3. systemctl status systemd-journald --no-pager: служба активна, в логе нет ошибок конфигурации.
  4. df -h /var: на разделе осталось место с запасом относительно SystemKeepFree.

Если после очистки объём не снизился, проверьте, не остались ли актуальные записи в активном файле: выполните journalctl --rotate и повторите vacuum. Если в журнале есть подозрительные записи, сохраните копию файлов журнала до удаления и разберитесь с причиной, чаще всего это нехватка места или некорректное завершение работы.

Типичные ошибки и как их избежать

Забыли --until. Вывод разрастается на мегабайты и вешает терминал. Исправление: всегда задавайте верхнюю границу окна, а для быстрой проверки добавляйте -n 200.

Перепутали направление приоритета. Ожидали только ошибки, а получили всё, что важнее, включая crit и alert. Исправление: помните, что -p err означает «err и выше по важности», а точные границы задаёт диапазон вида err..warning.

Сделали vacuum до выгрузки. Окно инцидента удалено, разбор остановлен. Исправление: сначала экспорт через -o json или short-iso, затем очистка, и только после проверки disk-usage.

Правили journald.conf без проверки. Опечатка в параметре оставляет службу без нужных лимитов или мешает старту. Исправление: меняйте по одному параметру, перезапускайте службу и смотрите systemctl status systemd-journald и journalctl -u systemd-journald -p err.

Не учли часовой пояс. Окно --since смещено на несколько часов, нужные записи не попали в выборку. Исправление: используйте абсолютные метки с явным форматом и --utc при сверке с другими системами.

Похожие грабли встречаются в скриптах администрирования, где отсутствие записи в journald и внятного кода выхода превращает сбой в тихую ошибку. Разбор с set -euo pipefail, trap и уведомлениями через systemd собран в статье о логировании и обработке ошибок в скриптах.

Короткая шпаргалка: команды под задачу

ЗадачаКомандаЗачем
Ошибки сервисаjournalctl -u nginx -p err --no-pagerубирает info и debug, оставляет проблемы
Окно инцидентаjournalctl --since '2026-01-15 09:55:00' --until '2026-01-15 10:15:00'точный интервал вместо всего журнала
Свежие событияjournalctl -n 50 -r --no-pagerбыстрый взгляд на хвост без листания
Текущая загрузкаjournalctl -b -p warning --no-pagerотсекает историю прошлых стартов
Конкретный процессjournalctl _PID=1234 --no-pagerловит записи дочернего процесса
Слежение в реальном времениjournalctl -u app -fвидно событие в момент воспроизведения
Выгрузка для разбораjournalctl -u app --since today -o json --no-pager > app.jsonмашинночитаемый файл для jq и тикета
Занятое местоjournalctl --disk-usageфакт вместо предположения о переполнении
Разовая очисткаjournalctl --rotate, затем journalctl --vacuum-size=500Mосвобождает диск, сохраняя активный журнал
Постоянный лимитSystemMaxUse=2G и SystemKeepFree=5G в journald.confжурнал не занимает диск целиком в будущем

Сохраните эту таблицу рядом с рабочими заметками и сверяйте синтаксис с man journalctl на каждом новом сервере: набор форматов вывода и полей зависит от версии systemd. Проверка одной командой перед массовым применением дешевле, чем разбор последствий на проде.

Источники и документация

Факты об опциях и форматах вывода journalctl, а также о настройках journald.conf сверяйте с первоисточниками:

Поделиться: