Урок 7 из 10Диагностика

12 мин · теория и практика · Основы

PostgreSQL: запуск, конфиг и подключения

Отличи кластер, который не стартует, от работающей базы, перегруженной клиентами.

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

Сообщение API «база недоступна» описывает взгляд клиента, а не состояние PostgreSQL. Кластер может не стартовать после ошибочной директивы, не слушать нужный адрес или исчерпать доступные подключения. До изменения параметров выясни, какая из этих ситуаций наблюдается.

Установи состояние кластера

В Debian pg_lsclusters показывает отдельные кластеры: версия, имя, порт и статус. Общее состояние postgresql.service не всегда описывает каждый кластер, поэтому сопоставь его с журналом и прослушиваемым портом. В учебном каскаде используй и предоставленные диагностические команды.

Команды
pg_lsclusters
systemctl status postgresql --no-pager
sudo journalctl -u postgresql -n 60 --no-pager

Первый PostgreSQL-кейс использует настоящий кластер; каскадный кейс моделирует часть показателей. SQL-примеры ниже относятся к доступной настоящей базе.

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

После деплоя ошибка часто указывает файл, строку и параметр. Проверь include и порядок файлов в conf.d, затем сравни добавленную настройку с допустимым форматом. Не удаляй каталог данных и не инициализируй новую базу из-за синтаксической ошибки конфигурации.

Команды
grep -n "include" /etc/postgresql/15/main/postgresql.conf
ls -l /etc/postgresql/15/main/conf.d
Пример вывода
invalid value for parameter "shared_buffers": "512XB"

Пример показывает ошибку единицы измерения, а не повреждение данных. Варианты кейса меняют файл и директиву; читай фактическую ошибку.

Для работающей базы проверь клиентов

В настоящей PostgreSQL pg_stat_activity показывает серверные процессы и их состояния. idle означает ожидание следующей команды клиента; idle in transaction дополнительно означает незавершённую транзакцию. Большое число подключений требует связи с пулом и нагрузкой приложения.

Команды
sudo -u postgres psql -c "SELECT state, count(*) FROM pg_stat_activity GROUP BY state;"
sudo -u postgres psql -c "SHOW max_connections;"

Представление требует доступа к базе; при полном отказе старта оно недоступно. Не начинай диагностику выключенного кластера с SQL-запроса.

Проверь настройки клиента и бюджет ожидания

Слишком долгий connect timeout удерживает запросы и ресурсы API. Неограниченные повторы создают дополнительную нагрузку. Увеличение max_connections не исправляет причины и может повысить расход памяти; сначала оцени клиентские таймауты, размер пулов и повторные обращения.

Команды
tail -n 40 /var/log/api.log
netstat -ant | head -n 20

Эти две команды полезны в каскадном кейсе. В рабочей PostgreSQL дополни их серверными метриками и pg_stat_activity.

Проверь данные и клиентский маршрут

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

От симптома к проверке

НаблюдениеСледующая проверкаКак читать результат
Кластер down после деплояЖурнал старта и добавленные includeНачни с названной директивы, а не восстановления данных с нуля.
Кластер up, много клиентских подключенийПулы, pg_stat_activity и таймауты APIИсследуй расход и удержание подключений приложением.
База поднялась, API продолжает перегрузкуЧастота повторов и динамика ресурсовПервый этап исправления мог открыть второй симптом каскада.

Типовые ошибки

  • Удалить данные или выполнить initdb из-за ошибки настройки.
  • Считать общий unit доказательством работы нужного кластера.
  • Повысить max_connections без проверки нагрузки и памяти.

Как доказать восстановление

  1. Проверь именно нужные версию, кластер и порт.
  2. Убедись, что исходные прикладные данные доступны.
  3. Повтори исходный API-запрос через обычный маршрут.
  4. Наблюдай подключения и ошибки после первого успешного ответа.

МИНИ-ИНЦИДЕНТ

Что сохранять при ошибке конфигурации?

После деплоя PostgreSQL не стартует и сообщает invalid value в новом conf.d-файле. Коллега предлагает пересоздать кластер. Какие факты нужны для более узкого решения?

Данные для разбора
configuration file: conf.d/95-tuning.conf
parameter: shared_buffers
value: 512XB
cluster status: down
Разобрать ход диагностики

Ошибка указывает параметр и формат, а не повреждение данных. Проверь включение файла, допустимые единицы и изменение деплоя. Исправь подтверждённую директиву, сохрани остальные настройки и данные, затем проверь запуск и запрос API.

ПРАКТИКУМ

Практикум: объясни данные и выбери действие

База принимает соединения, но API исчерпывает ожидание. Сопоставь запас подключений и поведение клиентов.

Учебные данные
max_connections=100
current client connections=98
API worker count=16
connection wait rising
  1. Почему работающий PostgreSQL не означает исправный API?

    Сверить рассуждение

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

  2. Какой расчёт помогает проверить гипотезу?

    Сверить рассуждение

    Оцени суммарный пул всех процессов и реплик с запасом для обслуживания. Например, 16 процессов по 10 подключений уже требуют больше 100, даже до других клиентов.

  3. Что наблюдать после изменения клиентского бюджета?

    Сверить рассуждение

    Доступные слоты, состояния подключений, время ответа API и отсутствие нового роста. Увеличение server limit без оценки памяти и причин удержания может только переместить границу отказа.

ПРОВЕРЬ СЕБЯ

API пишет connection timeout. Нужно сразу повышать max_connections?

Показать объяснение

Нет. Сначала проверь состояние кластера, адрес и доступность, затем число и поведение клиентов. Таймаут не доказывает достижение серверного лимита.

Документация

Гостевой прогресс хранится отдельно в этом браузере.

ТЕПЕРЬ В КОНСОЛЬ

Закрепи на инциденте

Сначала восстанови запуск PostgreSQL после изменения конфигурации. Затем исследуй каскад, где нужно ограничить давление приложения на базу.

ПОМОГЛО РАЗОБРАТЬСЯ?

Как тебе материал?

Оцени статью или напиши, где не хватило объяснения. Это поможет улучшить обучение.

Полезно 0 Не помогло 0

Войди, чтобы оценить статью и оставить комментарий.

Обсуждение

0

Войти в обсуждение →

Пока без комментариев. Поделись первым впечатлением или задай вопрос по теме.