Логування виконання запитів

Як і в будь-якій складній системі, у PostgreSQL бувають ситуації, коли щось іде не так: запити виконуються занадто довго, навантаження на сервер зростає, а користувачі починають нервувати. Логування — це спосіб спостерігати за внутрішньою роботою бази даних, щоб:

1. Виявити повільні запити — ті, які гальмують роботу застосунку.
2. Оптимізувати продуктивність — за рахунок аналізу поведінки запитів.
3. Діагностувати помилки — такі як порушення обмежень або неправильний синтаксис.
4. Забезпечити аудит — відстеження того, хто і які операції виконував на сервері.

Ключові параметри логування

Файли конфігурації PostgreSQL (postgresql.conf) містять купу параметрів, пов’язаних із логуванням. Давай розберемо найважливіші з них.

1. log_statement — логування SQL-запитів

Параметр log_statement визначає, які SQL-запити будуть записані в лог. Він може приймати такі значення:

• none — вимкнути логування запитів.
• ddl — логувати тільки команди визначення даних (наприклад, CREATE, ALTER, DROP).
• mod — логувати всі команди, що змінюють дані (наприклад, INSERT, UPDATE, DELETE).
• all — логувати всі SQL-запити (включаючи прості SELECT).

Приклад:

Щоб увімкнути логування всіх запитів, у файлі postgresql.conf постав:

log_statement = 'all'

Якщо хочеш логувати тільки команди зміни даних:

log_statement = 'mod'

Після зміни конфігурації не забудь перезапустити сервер:

sudo systemctl restart postgresql

2. log_duration — логування часу виконання

Параметр log_duration дозволяє записувати в лог час виконання кожного запиту. Це корисно, щоб з’ясувати, які запити найбільш затратні по часу.

Приклад:

Щоб увімкнути логування тривалості виконання запитів, постав:

log_duration = on

Якщо хочеш логувати тільки повільні запити, використовуй параметр log_min_duration_statement (про нього поговоримо трохи далі).

3. log_min_duration_statement — логування повільних запитів

Цей параметр дозволяє записувати в лог тільки ті запити, виконання яких займає більше вказаного часу (в мілісекундах). Це дуже зручно для виявлення "гальм" у базі даних.

Приклад:

Щоб логувати запити, які виконуються довше 1 секунди:

log_min_duration_statement = 1000

Якщо хочеш логувати ВСІ запити незалежно від їх тривалості, просто постав значення 0:

log_min_duration_statement = 0

Значення -1 вимикає логування по тривалості.

4. log_line_prefix — структура повідомлення в логу

Параметр log_line_prefix дозволяє налаштувати формат записуваних повідомлень. Це корисно для додавання контексту до кожного логованого запиту (наприклад, ім’я користувача, PID, дата і час).

Приклад:

Щоб записувати ім’я користувача, базу даних, час і процес, використовуй:

log_line_prefix = '%t [%p]: [%d]: [%u]: '

Тут:

• %t — час запиту.
• %p — PID процесу.
• %d — ім’я бази даних.
• %u — ім’я користувача.

Список всіх доступних опцій: Документація PostgreSQL.

5. logging_collector — збирач логів

Параметр logging_collector вмикає механізм запису логів у файли. Якщо він вимкнений, логи відправляються тільки у стандартний вивід (stdout), що може бути незручно.

Щоб активувати збирач логів:

logging_collector = on

Не забудь вказати шлях до файлу лога за допомогою log_directory і log_filename:

log_directory = '/var/log/postgresql'
log_filename = 'postgresql-%Y-%m-%d.log'

Практичне використання параметрів

Давай подивимось, як використовувати параметри логування у реальному сценарії.

Сценарій 1: логування всіх запитів

Якщо ти тільки почав працювати з новою базою даних і хочеш бачити все, що відбувається, налаштуй:

log_statement = 'all'
log_line_prefix = '%t [%p]: [%d]: [%u]: '

Тепер кожен запит, що виконується в базі, буде записаний у файл лога — зручно для відладки!

Сценарій 2: пошук повільних запитів

Якщо ти помітив, що сервер іноді "гальмує", і хочеш знайти проблемні запити, налаштуй:

log_min_duration_statement = 500  # Логуємо запити довше 500 мс
log_line_prefix = '%t [%p]: [%d]: [%u]: [%r] '

Де %r додає IP-адресу клієнта. Після налаштування ти зможеш легко знайти запити, що перевантажують сервер.

Сценарій 3: режим мінімального логування

Якщо твій сервер працює стабільно, але потрібен мінімальний набір логів для аудиту:

log_statement = 'mod'
log_duration = off

Тут логуються тільки зміни даних (наприклад, INSERT, UPDATE).

Аналіз логів

Коли логи починають наповнюватися даними, важливо вміти їх аналізувати! Ти можеш:

Відкрити файл з логами у текстовому редакторі:

cat /var/log/postgresql/postgresql.log

Використовувати інструменти для аналізу, наприклад, grep, щоб знайти повільні запити:

grep "duration: " /var/log/postgresql/postgresql.log

Використовувати утиліти для просунутого аналізу логів, такі як pgBadger.

Корисні поради

Занадто детальне логування може збільшити навантаження на диск. Використовуй для продуктивних систем тільки ті параметри, які реально потрібні.

Регулярно очищуй або архівуй старі файли логів, щоб не забити диск.

Логування ефективне з параметрами, які збирають тільки потрібні дані. Наприклад, log_min_duration_statement допомагає залишатися точним і економити ресурси.

Ну що? Тепер для нас не проблема налаштувати логування в PostgreSQL і ефективно використовувати його для аналізу запитів та підвищення продуктивності. Як сказав один (та ні, не один) невідомий, але явно крутий розробник: "Логи — це наша можливість зазирнути в минуле запитів і виправити майбутнє бази даних".