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:
| Уровень | Код | Что попадёт в выборку |
|---|---|---|
| emerg | 0 | отказ системы, работа продолжается только на аварийном режиме |
| alert | 1 | требуется немедленное вмешательство |
| crit | 2 | критическое состояние подсистемы |
| err | 3 | ошибки выполнения операций |
| warning | 4 | предупреждения, работа продолжается |
| notice | 5 | значимые, но штатные события |
| info | 6 | обычные информационные сообщения |
| debug | 7 | отладочный вывод |
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 не роняет прикладные сервисы, но выполняйте его в окно обслуживания и фиксируйте исходные значения параметров, чтобы откатиться одной правкой.
Проверка результата после очистки и настройки
Проверяйте эффект, а не намерение. Короткий чек-лист после изменений:
- journalctl --disk-usage: сравните с замером до очистки, объём должен снизиться.
- journalctl -n 20 --no-pager: новые записи продолжают поступать, журнал пишется.
- systemctl status systemd-journald --no-pager: служба активна, в логе нет ошибок конфигурации.
- 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 сверяйте с первоисточниками:
- man-страница journalctl (Ubuntu Manpage) — опции -u, -p, --since, --until, _PID и диапазоны приоритетов.
- journald.conf (freedesktop.org) — параметры SystemMaxUse, RuntimeMaxUse, SystemKeepFree и режимы хранения журнала.
- JOURNAL_EXPORT_FORMATS.md (systemd) — форматы -o json и -o export.
- systemd/Journal (ArchWiki) — доступ к системному журналу и группа systemd-journal.
- Настройка журналов с помощью journalctl (РЕД ОС) — --disk-usage, --vacuum-size, --vacuum-time.
- How to clear journalctl (Unix & Linux Stack Exchange) — очистка архивных логов и --rotate.
- Setting journalctl limits (Andreas Karis Blog) — примеры лимитов в journald.conf.
- Средства управления протоколированием событий (Альт) — --since/--until и -b.