Логирование

Евгения Кузина

Содержание

Настройка параметров логирования
Просмотр лог-файлов

В этой статье описывается как настроить логирование и просмотреть лог-файлы сервиса ADPG.

Настройка параметров логирования

Используйте ADCM, чтобы настроить параметры логирования.

Откройте страницу Clusters и кликните кластер ADPG. Перейдите на вкладку Services и кликните сервис ADPG.

Сервисы кластера ADPG

Откроется вкладка Primary configuration сервиса ADPG. Раскройте ноду ADPG configurations и кликните postgresql.conf.

Параметры сервиса ADPG

Откроется текстовое поле с параметрами конфигурации. В этом поле можно указать необходимые параметры логирования.

Поле "postgresql.conf"

Наиболее часто используемые настройки логирования перечислены в таблице.

Параметры логирования сервиса ADPG
Наименование параметра	Описание	Значение по умолчанию
logging_collector	Включает сборщик сообщений логирования (logging collector). Сборщик сообщений логирования — это фоновый процесс, который перехватывает сообщения логирования, отправленные в stderr, и перенаправляет их в файлы логов	Сборщик сообщений логирования включен (`true`)
log_directory	Определяет каталог, в который записываются лог-файлы. Может содержать абсолютный путь или путь относительно каталога с данными кластера ADPG	log (абсолютный путь — /pg_data1/adpg16/log)
log_filename	Задает шаблон имени лог-файла, может содержать спецификаторы % strftime для включения времени и даты создания в имя файла. Если спецификаторы % не заданы, используйте утилиты ротации лог-файлов, чтобы избежать переполнения диска	postgresql-%a.log
log_rotation_age	Определяет максимальный период использования лог-файла, после которого создается новый лог-файл. Если значение задано без единиц измерения, оно берется в минутах. Чтобы отключить создание лог-файлов по времени, установите значение `0`	1d
log_rotation_size	Определяет максимальный размер лог-файла. После того как лог-файл достигает указанного размера, создается новый лог-файл. Если значение задано без единиц измерения, оно берется в килобайтах. Чтобы отключить создание лог-файлов при превышении определенного размера, установите значение `0`	0
log_min_messages	Определяет минимальный уровень важности сообщений, которые записываются в лог-файл. Допустимые значения: `debug5`, `debug4`, `debug3`, `debug2`, `debug1`, `info`, `notice`, `warning`, `error`, `log`, `fatal` и `panic` (cм. таблицу Уровни важности лог-сообщений). Сообщения с заданной важностью и более важные записываются в лог-файл. Например, если вы установили значение `warning`, лог-файл будет включать сообщения с важностью `warning`, `error`, `log`, `fatal` и `panic`	warning
log_min_error_statement:	Определяет какие SQL-операторы, завершившиеся ошибкой, записываются в лог-файл. Допустимые значения: `debug5`, `debug4`, `debug3`, `debug2`, `debug1`, `info`, `notice`, `warning`, `error`, `log`, `fatal` и `panic` (cм. таблицу Уровни важности лог-сообщений). SQL-оператор будет записан в лог-файл, если он завершится ошибкой с указанным уровнем важности или выше. Чтобы отключить логирование SQL-операторов, установите значение `panic`	error

Ниже перечислены уровни важности сообщений, которые могут быть записаны в лог-файл.

Уровни важности лог-сообщений
Значение	Описание
Debug1..Debug5	Детальная информация для разработчиков. Чем больше номер, тем подробнее информация
Info	Неявно запрошенная пользователем информация, например вывод команды `VACUUM VERBOSE`
Notice	Информация, которая может быть полезной пользователям. Например, уведомления об усечении длинных идентификаторов
Warning	Предупреждения о возможных проблемах. Например, `COMMIT` вне транзакционного блока
Error	Сообщение об ошибке, из-за которой прервана текущая команда
Log	Информация, полезная для администраторов. Например, выполнение контрольных точек
Fatal	Сообщение об ошибке, из-за которой прервана текущая сессия
Panic	Сообщение об ошибке, из-за которой прерваны все сессии

Если вы изменили настройки логирования, выполните действие Reconfigure & Restart, чтобы применить изменения.

Все настройки, перечисленные выше — стандартные параметры конфигурации PostgreSQL сервера. Вы можете найти дополнительную информацию на официальном сайте: Error Reporting and Logging.

ВНИМАНИЕ

Когда сервис ADPG выполняет Reconfigure & Restart, файл postgresql.conf перезаписывается с настройками, указанными в Services → ADPG → Configuration. Если вы изменили файл postgresql.conf напрямую, эти изменения будут потеряны.

Просмотр лог-файлов

Вы можете найти лог-файлы на хосте, на котором установлен ADPG.

Подключитесь к хосту (например, по SSH) и выполните команду ls, передав путь к каталогу с лог-файлами как параметр (в этом примере путь — /pg_data1/adpg16/log):

$ sudo ls -la /pg_data1/adpg16/log

Вы получите список лог-файлов в каталоге:

total 10708
drwx------  2 postgres postgres     136 May 26 00:00 .
drwx------ 20 postgres postgres    4096 May 26 08:54 ..
-rw-------  1 postgres postgres    1009 May 20 13:31 postgresql-Fri.log
-rw-------  1 postgres postgres     596 May 23 06:30 postgresql-Mon.log
-rw-------  1 postgres postgres 3803084 May 26 10:04 postgresql-Thu.log
-rw-------  1 postgres postgres     988 May 24 07:37 postgresql-Tue.log
-rw-------  1 postgres postgres 3343041 May 25 23:59 postgresql-Wed.log

Вы можете использовать команду tail, чтобы просмотреть лог-файл:

$ sudo tail /pg_data1/adpg16/log/postgresql-Mon.log

Результат:

2022-05-23 06:30:40.804 GMT [951] LOG:  starting PostgreSQL 14.2 on x86_64-pc-linux-gnu, compiled by gcc (GCC) 4.8.5 20150623 (Red Hat 4.8.5-44), 64-bit
2022-05-23 06:30:40.804 GMT [951] LOG:  listening on IPv6 address "::1", port 5432
2022-05-23 06:30:40.804 GMT [951] LOG:  listening on IPv4 address "127.0.0.1", port 5432
2022-05-23 06:30:40.813 GMT [951] LOG:  listening on Unix socket "/tmp/.s.PGSQL.5432"
2022-05-23 06:30:40.845 GMT [1079] LOG:  database system was shut down at 2022-05-20 13:31:40 GMT
2022-05-23 06:30:40.972 GMT [951] LOG:  database system is ready to accept connections

Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней