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

Журнал PostgreSQL: где лежит и как читать

В Ubuntu журнал PostgreSQL лежит в файле /var/log/postgresql/postgresql-16-main.log. В нём причина, если база не запускается, сайт не может войти или запрос падает с ошибкой. Последние строки показывает команда sudo tail -n 50.

≈ 7 мин чтения
Содержание 9

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Покажите последние 50 строк журнала:
sudo tail -n 50 /var/log/postgresql/postgresql-16-main.log
  1. Ищите снизу вверх строки со словами FATAL, ERROR или PANIC — в них причина. Как их читать — ниже.
  2. Чтобы смотреть журнал вживую, наберите sudo tail -f /var/log/postgresql/postgresql-16-main.log и повторите на сайте действие с ошибкой: новые строки появятся сразу. Выйти — Ctrl+C.

Если файла с таким именем нет, посмотрите, какие журналы есть: ls /var/log/postgresql/. В имени файла — номер версии PostgreSQL: у версии 17 он называется postgresql-17-main.log.

Где лежит журнал

ЧтоГде
журнал кластера 16 main/var/log/postgresql/postgresql-16-main.log
старые журналытам же: .log.1, затем сжатые .log.2.gz и дальше
журнал другой версии или кластера/var/log/postgresql/postgresql-версия-имя.log
как журнал чистится/etc/logrotate.d/postgresql-common

Имя файла задают программы Ubuntu, которые запускают базу, а не postgresql.conf. Файл создаётся при создании кластера, читать его могут только пользователь postgres и группа adm — поэтому команды с журналом пишут через sudo.

Если в postgresql.conf включена настройка logging_collector = on, база сама раскладывает журнал по файлам в папке из настройки log_directory. По умолчанию это папка log внутри /var/lib/postgresql/16/main, а имя файла содержит дату и время. Включается и выключается logging_collector только перезапуском базы.

Сжатые старые журналы читают так: sudo zcat /var/log/postgresql/postgresql-16-main.log.2.gz | tail -n 50.

Как читать строку журнала

2026-11-05 10:15:02.131 UTC [812] LOG:  database system is ready to accept connections
2026-11-05 10:21:40.552 UTC [1290] ivan@shop FATAL:  password authentication failed for user "ivan"
2026-11-05 10:21:40.552 UTC [1290] ivan@shop DETAIL:  Password does not match for user "ivan".
	Connection matched file "/etc/postgresql/16/main/pg_hba.conf" line 123: "host    all             all             127.0.0.1/32            scram-sha-256"
Часть строкиЧто значит
2026-11-05 10:21:40.552 UTCдата и время по часовому поясу сервера
[1290]номер процесса: у одного подключения он одинаковый во всех строках
ivan@shopпользователь и база; в строках, которые пишет сама база, а не подключение, этой части нет
FATALважность строки, таблица ниже
после двоеточиятекст сообщения
DETAILпояснение к строке выше, с тем же номером процесса

В примере сайт вошёл под ivan с неверным паролем. DETAIL поясняет: пароль не совпал, а вход сопоставлен со строкой файла pg_hba.conf — номер строки и её текст будут вашими. Такие пояснения пишутся только в журнал: сайт их не получает, поэтому журнал и нужен.

Вид начала строки задаёт настройка log_line_prefix. В Ubuntu она равна '%m [%p] %q%u@%d ': время, номер процесса, пользователь и база.

Что значат LOG, ERROR, FATAL и PANIC

СловоЧто случилось
LOGсообщение для администратора: база запустилась, остановилась, сделала контрольную точку
WARNINGпредупреждение: работа продолжается
ERRORодна команда не выполнена, подключение живо
FATALподключение закрыто: не прошёл вход, нет базы, слишком много подключений
PANICостановлена вся база: смотрите строки перед этой
DETAIL, HINT, STATEMENTпояснение, подсказка и текст команды к строке выше

Строки, которые стоит знать:

  • database system is ready to accept connections — база запустилась и принимает подключения.
  • listening on IPv4 address "127.0.0.1", port 5432 — на каком адресе и порту база ждёт подключений.
  • received fast shutdown request — базу остановили командой.
  • FATAL: sorry, too many clients already — кончились подключения: разбор ошибки.

Какие настройки журнала включить

Заведите отдельный файл, чтобы не искать строки в длинном postgresql.conf. Ubuntu читает все файлы .conf из папки conf.d:

sudo nano /etc/postgresql/16/main/conf.d/zhurnal.conf

Вставьте строки, которые нужны:

log_connections = on
log_disconnections = on
log_min_duration_statement = 1000
log_lock_waits = on
log_temp_files = 0

Сохраните (Ctrl+O, Enter, Ctrl+X) и перечитайте настройки — перезапуск не нужен:

sudo pg_ctlcluster 16 main reload
НастройкаЧто пишет в журналПо умолчанию
log_connectionsкаждое подключение: кто и откудаoff
log_disconnectionsкаждое отключение и сколько длилось подключениеoff
log_min_duration_statementзапросы дольше заданного числа миллисекунд; −1 — выключено−1
log_lock_waitsзапросы, которые ждали чужую блокировку дольше секундыoff
log_temp_filesзапросы, которым не хватило памяти и пришлось писать временный файл; 0 — любой−1
log_statementкоманды: none — никакие, ddl — CREATE, ALTER, DROP, mod — ещё и изменения данных, all — всеnone
log_checkpointsконтрольные точкиon
log_autovacuum_min_durationдолгая автоочистка таблиц10min

log_connections и log_disconnections нужны, если кто-то подбирает пароль или сайт открывает слишком много подключений. psql при входе может подключиться дважды, пока выясняет, нужен ли пароль, — две строки connection received подряд от psql не ошибка.

log_statement = all пишет в журнал каждую команду, в том числе пароли из ALTER USER и данные посетителей. На загруженном сайте журнал быстро займёт диск. Включайте её на несколько минут, чтобы найти ошибку, затем верните none.

Как искать медленные запросы через log_min_duration_statement — на странице Медленные запросы.

Как журнал чистится сам

В Ubuntu журналы PostgreSQL обрабатывает logrotate по файлу /etc/logrotate.d/postgresql-common:

  • раз в неделю текущий журнал становится файлом .log.1, а запись продолжается в чистый файл;
  • хранятся 10 старых журналов, более старые удаляются;
  • старые журналы сжимаются, начиная со второго;
  • пустой журнал не трогается.

Сколько места занимают журналы: sudo du -sh /var/log/postgresql/. Если журнал вырос за несколько дней, проверьте, не включена ли log_statement = all, и посмотрите, какая строка повторяется: sudo tail -n 200 /var/log/postgresql/postgresql-16-main.log.

Если в журнале пусто или его нет

Что видитеПричинаЧто делать
нет папки /var/log/postgresqlPostgreSQL не установленКак установить PostgreSQL
tail отвечает, что нет доступа к файлуфайл читают только postgres и группа admдобавьте sudo перед командой
в журнале нет свежих строквключён logging_collector, журнал пишется в другую папкуsudo -u postgres psql -c 'SHOW logging_collector;'; если on — смотрите SHOW log_directory;
в ошибке на сайте нет строки с номером строки pg_hba.confэто пояснение сайт не получаетсмотрите журнал на сервере

Всё сверено с PostgreSQL 16 — эта версия ставится в Ubuntu 24.04.

Источники

Сверено 5 ноября 2026 года.

Если не хочется держать базу на своём сервере. Есть облачные базы данных: MySQL, PostgreSQL или Redis без своего VPS, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Когда это выгоднее своего сервера, а когда нет, — в статье Сервер для базы данных.

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