20.11 Message Logging Options — MySQL Enterprise Backup 8.4

20.11 Параметры ведения журнала сообщений

mysqlbackup записывает важную информацию о ходе выполнения и ошибках в поток stderr. Эта информация часто очень полезна для выявления проблем, возникающих во время операции. Начиная с MySQL Enterprise Backup 3.9, вывод в поток stderr по умолчанию также сохраняется в файле журнала (для большинства операций mysqlbackup), чтобы информация об ошибках была легко доступна в любом процессе отладки.

Ведение журнала сообщений работает как процесс tee в системе Unix-подобной системе, в котором вывод программы разделяется, чтобы отображаться и сохраняться в файле. Созданный таким образом файл журнала имеет следующий формат: MEB_timestamp_operation.log, где operation - это операция mysqlbackup, которая выполнялась (например, backup, apply-log и т.д.), а timestamp - дата и время выполнения операции. Вот несколько примеров имён файлов журнала:

MEB_2013-06-24.16-32-43_backup.log
MEB_2013-06-28.11-07-18_apply_log.log
MEB_2013-06-29.10-08-06_list_image.log

Следующие параметры управляют функцией ведения журнала сообщений:

--skip-messages-logdir

Пропустить ведение журнала сообщений. Ведение журнала включено по умолчанию (кроме операций list-image и validate; см. описание параметра --messages-logdir для получения подробностей), и этот параметр его отключает.
--messages-logdir=path

Формат командной строки --messages-logdir=PATH

Тип Имя каталога

Значение по умолчанию backup_dir/meta

Указывает имя пути к существующему каталогу для хранения журнала сообщений. Если указанный каталог не существует, ведение журнала завершится с ошибкой. При отсутствии этого параметра используется каталог по умолчанию backup_dir/meta, где backup_dir - это каталог, указанный с параметром --backup-dir.

Примечание

Используйте этот параметр для включения ведения журнала сообщений для операций list-image и validate. Ведение журнала сообщений выключено по умолчанию для этих двух операций, так как они не изменяют файлы, и журнал сообщений обычно не требуется для их отладки. И так как путь по умолчанию backup_dir/meta не имеет смысла для этих двух операций, этот параметр необходим как для включения ведения журнала сообщений, так и для указания пути к каталогу для сохранения файла журнала. Однако, если указан параметр --skip-messages-logdir, он имеет приоритет, и ведение журнала сообщений пропущено.

Формат командной строки	`--messages-logdir=PATH`
Тип	Имя каталога
Значение по умолчанию	`backup_dir/meta`

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

Это создаёт файл журнала для операции backup в каталоге /home/backup_dir/meta из-за настроек по умолчанию:

mysqlbackup -uroot --port=3306 --backup-dir=/home/backup_dir backup

Это пропускает ведение журнала сообщений для операции backup:

mysqlbackup -uroot --port=3306 --backup-dir=/home/backup_dir \
      --skip-messages-logdir backup

Это создает файл журнала для операции apply-log в существующем каталоге с именем /home/teelog_dir, а не по умолчанию:

mysqlbackup -uroot --port=3306 --backup-dir=/home/backup_dir \
      --messages-logdir=/home/teelog_dir apply-log

Это создаёт файл журнала для операции list-image в существующем каталоге с именем /home/teelog_dir:

mysqlbackup -uroot --port=3306 --backup-image=/backup/my.mbi \
      --messages-logdir=/home/teelog_dir list-image