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

SELECT audit_log_filter_set_filter('log_all', '{ "filter": { "log": true } }');
SELECT audit_log_filter_set_user('%', 'log_all');

Как уже упоминалось, SQL-интерфейс для управления фильтрацией аудита основан на функциях. Следующий список кратко описывает эти функции:

Примеры использования и полные сведения о функциях фильтрации см. в разделах «Использование функций фильтрации аудиторского журнала» и «Функции аудиторского журнала».

Функции фильтрации аудиторского журнала ограничены следующими условиями:

Перед использованием функций журнала аудита установите их в соответствии с инструкциями, предоставленными в разделе 6.4.5.2, «Установка или удаление MySQL Enterprise Audit». Для использования любой из этих функций требуется привилегия SUPER.

Функции фильтрации журнала аудита позволяют контролировать фильтрацию, предоставляя интерфейс для создания, изменения и удаления определений фильтров и назначения фильтров учетным записям пользователей.

Определения фильтров представляют собой JSON значения. Сведения об использовании JSON данных в MySQL см. в разделе 11.5, «Тип данных JSON». В этом разделе показаны некоторые простые определения фильтров. Дополнительные сведения об определениях фильтров см. в разделе 6.4.5.8, «Написание определений фильтров журнала аудита».

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

Если в течение сессии происходит операция смены пользователя (см. ), назначение фильтра для сессии обновляется по тем же правилам, но для нового пользователя.

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

Предположим, что вы хотите изменить значение по умолчанию на протоколирование только связанной с подключением активности (например, для просмотра событий подключения, смены пользователя и отключения, но не SQL-запросов, выполняемых пользователями во время подключения). Для этого определите фильтр (называемый здесь log_conn_events), который позволяет протоколировать только события в классе connection, и назначьте этот фильтр учетной записи по умолчанию, представленной именем учетной записи %:

SET @f = '{ "filter": { "class": { "name": "connection" } } }';
SELECT audit_log_filter_set_filter('log_conn_events', @f);
SELECT audit_log_filter_set_user('%', 'log_conn_events');

Теперь журнал аудита использует этот фильтр учетной записи по умолчанию для подключений от любой учетной записи, которой явно не определен фильтр.

Чтобы явно назначить фильтр конкретной учетной записи пользователя или нескольким учетным записям, определите фильтр, а затем назначьте его соответствующим учетным записям:

SELECT audit_log_filter_set_filter('log_all', '{ "filter": { "log": true } }');
SELECT audit_log_filter_set_user('user1@localhost', 'log_all');
SELECT audit_log_filter_set_user('user2@localhost', 'log_all');

Теперь полное протоколирование включено для user1@localhost и user2@localhost. Подключения от других учетных записей по-прежнему фильтруются с использованием фильтра учетной записи по умолчанию.

Чтобы отвязать учетную запись пользователя от текущего фильтра, либо отменить назначение фильтра, либо назначить другой фильтр:

Для фильтрации журнала аудита сравнения имен пользователей и имен хостов регистрозависимые. Это отличается от сравнений для проверки привилегий, для которых сравнения имен хостов не регистрозависимые.

Для удаления фильтра выполните следующие действия:

SELECT audit_log_filter_remove_filter('log_nothing');

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

Описанные выше функции фильтрации аудита влияют на фильтрацию аудита немедленно и обновляют таблицы журнала аудита в базе данных системы mysql, в которых хранятся фильтры и учетные записи пользователей (см. Таблицы журнала аудита). Также возможно напрямую изменять таблицы журнала аудита с помощью таких операторов, как INSERT, UPDATE и DELETE, но такие изменения не влияют на фильтрацию немедленно. Чтобы применить внесенные изменения и сделать их действующими, вызовите audit_log_filter_flush():

SELECT audit_log_filter_flush();

Чтобы определить, назначен ли фильтр текущей сессии, проверьте значение сессии для системной переменной только для чтения audit_log_filter_id. Если значение равно 0, фильтр не назначен. ненулевое значение указывает внутренний ID назначенного фильтра:

mysql> SELECT @@audit_log_filter_id;
+-----------------------+
| @@audit_log_filter_id |
+-----------------------+
|                     2 |
+-----------------------+