5.2 Using the Logging Feature — MySQL Router 8.4

5.2 Использование функции ведения журнала

Функция ведения журнала может быть полезна для разработки и тестирования вашего приложения и развертывания MySQL Router. Для использования ведения журнала включите параметр ведения журнала level в файле конфигурации в разделе с именем [logger]. Например:

[logger]
level = INFO

Установите расположение файла журнала с помощью параметра logging_folder, определенного как путь к каталогу в разделе [DEFAULT] файла конфигурации. Файл журнала имеет имя mysqlrouter.log. Например:

[DEFAULT]
# Logs are sent to /path/to/folder/mysqlrouter.log
logging_folder = /path/to/folder

[logger]
level = DEBUG

Указание logging_folder в пустую строку отправляет логи в консоль (stdout).

Два распространенных уровня ведения журнала — INFO (по умолчанию) и DEBUG:

INFO: включает информационные сообщения, подобные показанным выше, и является значением по умолчанию.
DEBUG: включает сообщения, сгенерированные внутри исходного кода Router для использования в диагностике. DEBUG предоставляет подробную информацию о внутренней работе Router. Хотя она может быть неинтересна для приложения, использование DEBUG может быть полезно, если у вас возникла проблема или Router ведет себя не так, как ожидалось.

Следующий пример показывает, как выглядят сообщения для уровня ведения журнала DEBUG; сравните сообщения INFO и DEBUG:

2019-04-07 18:25:56 INFO    [0x700009673000] Connections using ssl_mode 'PREFERRED'
2019-04-07 18:25:56 INFO    [0x700009673000] Connected with metadata server running on 127.0.0.1:3310
2019-04-07 18:25:56 DEBUG   [0x700009673000] Updating metadata information for cluster 'devCluster'
2019-04-07 18:25:56 DEBUG   [0x700009673000] Updating replicaset status from GR for 'default'
2019-04-07 18:25:56 DEBUG   [0x700009673000] Replicaset 'default' has 3 members in metadata, 3 in status table
2019-04-07 18:25:56 DEBUG   [0x700009673000] End updating replicaset for 'default'
2019-04-07 18:25:56 INFO    [0x700009673000] Changes detected in cluster 'devCluster' after metadata refresh
2019-04-07 18:25:56 INFO    [0x700009673000] Metadata for cluster 'devCluster' has 1 replicasets:

Вращение логов

Router поддерживает вращение логов; здесь представлены сценарии с примерами реализации.

Примечание

Эта функциональность не поддерживается в Windows.

Вращение по запросу

Вращение логов по запросу может быть выполнено в два шага: переименование файла журнала и уведомление Router о создании и переключении на новый файл журнала.

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

sudo mv /var/log/mysqlrouter/mysqlrouter.log /var/log/mysqlrouter/mysqlrouter.log.old
kill -HUP $(pidof mysqlrouter)

logrotate

Механизм logrotate также может вращать файл журнала Router. После вращения Router будет уведомлен о необходимости повторного открытия файла журнала, и это достигается путем отправки сигнала HUP процессу Router. Пример файла конфигурации logrotate:

/var/log/mysqlrouter/mysqlrouter.log {
    rotate 9
    size 10M
    create 0755 mysqlrouter mysqlrouter
    postrotate
    kill -HUP $(pidof mysqlrouter)
    endscript
}

В примере логи вращаются как mysqlrouter.log, mysqlrouter.log.1, ..., mysqlrouter.log.9. Вращение запускается на основе размера текущего файла mysqlrouter.log, только если размер превышает 10 МБ. Предполагая, что эта конфигурация сохранена как /etc/mysqlrouter/logrotate.conf, она может выполняться периодически (добавлена в cron) следующим образом:

[sudo] logrotate  /etc/mysqlrouter/logrotate.conf