Логирование

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

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

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

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

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

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

ADPG log settings
Параметры логирования сервиса ADPG

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

Параметры логирования сервиса ADPG
Наименование параметра Описание Значение по умолчанию

logging_collector

Включает сборщик сообщений логирования (logging collector). Сборщик сообщений логирования — это фоновый процесс, который перехватывает сообщения логирования, отправленные в stderr, и перенаправляет их в файлы логов. Если вы изменили этот параметр, выполните Reconfigure & Restart, чтобы применить изменения

Сборщик сообщений логирования включен (true)

log_directory

Определяет каталог, в который записываются лог-файлы. Может содержать абсолютный путь или путь относительно каталога с данными кластера ADPG

log
(абсолютный путь — /pg_data1/adpg14/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 или Reconfigure & Reload, чтобы применить изменения.

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

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

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

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

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

    $ sudo ls -la /pg_data1/adpg14/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
  2. Вы можете использовать команду tail, чтобы просмотреть лог-файл:

    $ sudo tail /pg_data1/adpg14/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 чтобы сообщить о ней