6.3.11.5. Контрольные Опции Плагина Журнала и Переменные

Этот раздел описывает опции команды и системные переменные, которые управляют работой контрольного плагина журнала. Если значения, определенные во время запуска, являются неправильными, плагин может быть не в состоянии инициализировать должным образом, и сервер не загружает это. В этом случае сервер может также произвести сообщения об ошибках для других контрольных настроек журнала, потому что он не будет распознавать их.

Управлять активацией audit_log плагин, используйте эту опцию:

--audit-log[=value]

Формат командной строки	`--audit-log[=value]`
Формат файла опции	`audit-log`
	Разрешенные Значения
	Ввести	`enumeration`
	Значение по умолчанию	`ON`
	Допустимые Значения	`ON`
		`OFF`
		`FORCE`
		`FORCE_PLUS_PERMANENT`

Эта опция управляет, как сервер загружается audit_log плагин при запуске. Это доступно, только если контрольный плагин журнала был ранее зарегистрирован в INSTALL PLUGIN или загружается --plugin-load. См. Раздел 6.3.11.1, "Устанавливая Контрольный Плагин Журнала".

Значение опции должно быть одним из доступных для загружающих плагин опций, как описано в Разделе 5.1.8.1, "Устанавливая и Удаляя Плагины". Например, --audit-log=FORCE_PLUS_PERMANENT говорит серверу загружать плагин и препятствовать тому, чтобы это было удалено, в то время как сервер работает.

Если audit_log плагин устанавливается, он представляет несколько системных переменных, которые разрешают управление журналированием:

mysql> SHOW VARIABLES LIKE
        'audit_log%';+--------------------------+--------------+| Variable_name            | Value        |+--------------------------+--------------+| audit_log_buffer_size    | 1048576      || audit_log_file           | audit.log    || audit_log_flush          | OFF          || audit_log_policy         | ALL          || audit_log_rotate_on_size | 0            || audit_log_strategy       | ASYNCHRONOUS |+--------------------------+--------------+

Можно установить любую из этих переменных при запуске сервера, и некоторых из них во времени выполнения.

audit_log_buffer_size

Системное Имя переменной	`audit_log_buffer_size`
Переменный Контекст	Глобальная переменная
Динамическая Переменная	Нет
	Разрешенные Значения
	Диаметр долота платформы	`32`
	Ввести	`numeric`
	Значение по умолчанию	`1048576`
	Диапазон	`4096 .. 4294967295`
	Разрешенные Значения
	Диаметр долота платформы	`64`
	Ввести	`numeric`
	Значение по умолчанию	`1048576`
	Диапазон	`4096 .. 18446744073709547520`

Когда контрольный плагин журнала пишет события в журнал асинхронно, это использует буфер, чтобы сохранить содержание события до записи их. Эта переменная управляет размером того буфера в байтах. Сервер корректирует значение к кратному числу 4096. Плагин использует единственный буфер, который он выделяет, когда он инициализирует и удаляет, когда он завершается. Плагин выделяет этот буфер, только если журналирование является асинхронным.

Эта переменная доступна только если audit_log плагин включается.

audit_log_file

Системное Имя переменной	`audit_log_file`
Переменный Контекст	Глобальная переменная
Динамическая Переменная	Нет
	Разрешенные Значения
	Ввести	`string`
	Значение по умолчанию	`audit.log`

Имя файла, в который контрольный плагин журнала пишет события. Значение по умолчанию audit.log. Если имя файла является относительным путем, сервер интерпретирует его относительно каталога данных. Для соображений безопасности контрольный файл журнала должен быть записан каталогу, доступному только для сервера MySQL и пользователей с законной причиной просмотреть журнал.

Эта переменная доступна только если audit_log плагин включается.

audit_log_flush

Системное Имя переменной	`audit_log_flush`
Переменный Контекст	Глобальная переменная
Динамическая Переменная	Да
	Разрешенные Значения
	Ввести	`boolean`
	Значение по умолчанию	`OFF`

Когда эта переменная устанавливается во включенный (1 или ON), контрольный плагин журнала закрывает и вновь открывает свой файл журнала, чтобы сбросить это. (Значение остается OFF так, чтобы Вы не отключили это явно прежде, чем позволить этому снова выполнить другой сброс.) Включающий этой переменной не имеет никакого эффекта если audit_log_rotate_on_size 0.

Эта переменная доступна только если audit_log плагин включается.

audit_log_policy

Системное Имя переменной	`audit_log_policy`
Переменный Контекст	Глобальная переменная
Динамическая Переменная	Да
	Разрешенные Значения
	Ввести	`enumeration`
	Значение по умолчанию	`ALL`
	Допустимые Значения	`ALL`
		`NONE`
		`LOGINS`
		`QUERIES`

Политика, управляющая информацией, записанной контрольным плагином журнала его файлу журнала. Следующая таблица показывает разрешенные значения.

Значение	Описание
`ALL`	Зарегистрируйте все события
`NONE`	Ничего не зарегистрируйте (отключите контрольный поток),
`LOGINS`	Зарегистрируйте только события входа в систему
`QUERIES`	Зарегистрируйте только события запроса

Эта переменная доступна только если audit_log плагин включается.

audit_log_rotate_on_size

Системное Имя переменной	`audit_log_rotate_on_size`
Переменный Контекст	Глобальная переменная
Динамическая Переменная	Да
	Разрешенные Значения
	Ввести	`numeric`
	Значение по умолчанию	`0`

Если audit_log_rotate_on_size значение больше чем 0, контрольный плагин журнала закрывает и вновь открывает свой файл журнала, если запись к файлу заставляет свой размер превышать это значение. Исходный файл переименовывается, чтобы иметь расширение метки времени.

Если audit_log_rotate_on_size значение 0, плагин не закрывает и вновь открывает свой журнал, основанный на размере. Вместо этого используйте audit_log_flush закрыть и вновь открыть журнал по требованию. В этом случае переименуйте файл внешне к серверу прежде, чем сбросить это.

Для получения дополнительной информации о контрольном вращении файла журнала и интерпретации метки времени, см. Раздел 6.3.11.4, "Контрольный Плагин Журнала, Регистрирующий Управление".

Если Вы устанавливаете эту переменную в значение, которое не является кратным числом 4096, это является усеченным к самому близкому кратному числу.

Эта переменная доступна только если audit_log плагин включается.

audit_log_strategy

Системное Имя переменной	`audit_log_strategy`
Переменный Контекст	Глобальная переменная
Динамическая Переменная	Нет
	Разрешенные Значения
	Ввести	`enumeration`
	Значение по умолчанию	`ASYNCHRONOUS`
	Допустимые Значения	`ASYNCHRONOUS`
		`PERFORMANCE`
		`SEMISYNCHRONOUS`
		`SYNCHRONOUS`

Метод журналирования используется контрольным плагином журнала. Следующая таблица описывает разрешенные значения.

Таблица 6.15. Контрольные Стратегии Журнала

Значение	Значение
`ASYNCHRONOUS`	Зарегистрируйте асинхронно, ожидайте пространства в буфере вывода
`PERFORMANCE`	Зарегистрируйте асинхронно, отбросьте запрос если недостаточное пространство в буфере вывода
`SEMISYNCHRONOUS`	Зарегистрируйте синхронно, разрешите кэшироваться операционной системой
`SYNCHRONOUS`	Зарегистрируйте синхронно, вызовите `sync()` после каждого запроса

Эта переменная доступна только если audit_log плагин включается.