16.11 Message Logging Options — MySQL Enterprise Backup 4.1

16.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