Журнал PostgreSQL: где лежит и как читать
В Ubuntu журнал PostgreSQL лежит в файле /var/log/postgresql/postgresql-16-main.log. В нём причина, если база не запускается, сайт не может войти или запрос падает с ошибкой. Последние строки показывает команда sudo tail -n 50.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Покажите последние 50 строк журнала:
sudo tail -n 50 /var/log/postgresql/postgresql-16-main.log- Ищите снизу вверх строки со словами
FATAL,ERRORилиPANIC— в них причина. Как их читать — ниже. - Чтобы смотреть журнал вживую, наберите
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/postgresql | PostgreSQL не установлен | Как установить 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.
Источники
- PostgreSQL 16: Error Reporting and Logging — на английском: logging_collector, log_directory, log_line_prefix, log_connections, log_statement, log_min_duration_statement, значения по умолчанию и уровни важности.
- Справка pg_ctlcluster для Ubuntu 24.04 — на английском: журнал кластера в /var/log/postgresql/.
- Справка pg_createcluster для Ubuntu 24.04 — на английском: файл журнала создаётся вместе с кластером, папка conf.d.
- Исходный код pg_createcluster для Ubuntu 24.04 — права на файл журнала: postgres и группа adm.
- postgresql-common: logrotate — на английском: раз в неделю, 10 файлов, сжатие.
- Исходный код PostgreSQL 16: auth.c — строка Connection matched file … line и то, что пояснение пишется только в журнал.
- Исходный код PostgreSQL 16: postmaster.c — строки ready to accept connections и received fast shutdown request.
Сверено 5 ноября 2026 года.
Что почитать дальше
- Медленные запросыкак найти, какой запрос тормозит сайт.
- Настройки PostgreSQLгде лежат файлы настроек и как их перечитать.
- Ошибки PostgreSQLразборы ошибок по тексту из журнала.
- pg_hba.confкто и как может входить в базу.