7.5.3 Error Log Components — MySQL 9.2

7.5.3 Компоненты журнала ошибок

В этом разделе описаны характеристики отдельных компонентов журнала ошибок. Для общей информации о настройке ведения журнала ошибок см. Раздел 7.4.2, «Журнал ошибок».

Компонент журнала может быть фильтром или приемником:

Фильтр обрабатывает события журнала, чтобы добавить, удалить или изменить поля событий или полностью удалить события. Результирующие события передаются следующему компоненту журнала в списке включенных компонентов.
Приемник является местом назначения (записью) для событий журнала. Как правило, приемник обрабатывает события журнала в сообщения журнала, которые имеют определенный формат, и записывает эти сообщения в соответствующий выход, такой как файл или системный журнал. Приемник также может записывать в таблицу схемы производительности error_log; см. Раздел 29.12.22.2, «Таблица error_log». События передаются без изменений следующему компоненту журнала в списке включенных компонентов (то есть, хотя приемник форматирует события для создания сообщений вывода, он не изменяет события, когда они передаются внутри к следующему компоненту).

Системная переменная log_error_services перечисляет включенные компоненты журнала. Компоненты, не указанные в списке, отключены. log_error_services также неявно загружает компоненты журнала ошибок, если они еще не загружены. Дополнительную информацию см. в Разделе 7.4.2.1, «Настройка журнала ошибок».

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

Описания компонентов включают следующие типы информации:

Название компонента и его назначение.
Является ли компонент встроенным или его необходимо загрузить. Для загружаемого компонента описание указывает URN, который следует использовать, если компонент явно загружается или выгружается с помощью операторов INSTALL COMPONENT и UNINSTALL COMPONENT. Для неявной загрузки компонентов журнала ошибок требуется только имя компонента. Дополнительную информацию см. в Разделе 7.4.2.1, «Настройка журнала ошибок».
Можно ли несколько раз указать компонент в значении log_error_services.
Для компонента приемника – место назначения, в которое компонент записывает вывод.
Для компонента приемника, поддерживает ли он интерфейс к таблице схемы производительности error_log.

Компоненты фильтра журнала ошибок

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

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

Компонент log_filter_internal

Назначение: Реализует фильтрацию на основе приоритета события журнала и кода ошибки в сочетании с системными переменными log_error_verbosity и log_error_suppression_list. См. Раздел 7.4.2.5, «Фильтрация журнала ошибок на основе приоритета (log_filter_internal)».
URN: Этот компонент встроен и не требует загрузки.
Разрешено несколько применений: Нет.

Если log_filter_internal отключен, log_error_verbosity и log_error_suppression_list не имеют эффекта.

Компонент log_filter_dragnet

Назначение: Реализует фильтрацию на основе правил, определенных настройкой системной переменной dragnet.log_error_filter_rules. См. Раздел 7.4.2.6, «Фильтрация журнала ошибок на основе правил (log_filter_dragnet)».
URN: file://component_log_filter_dragnet
Разрешено несколько применений: Нет.

Компоненты стока журнала ошибок

Компоненты стока журнала ошибок — это записывающие компоненты, реализующие вывод в журнал ошибок. Если ни один компонент стока не включен, вывод в журнал не происходит.

Некоторые описания компонентов стока относятся к целевому назначению журнала ошибок по умолчанию. Это консоль или файл, и это указывается значением системной переменной log_error, определяемой, как описано в разделе 7.4.2.2, «Настройка целевого назначения журнала ошибок по умолчанию».

Компонент log_sink_internal

Назначение: Реализует традиционный формат вывода сообщений журнала ошибок.
URN: Этот компонент встроен и не требует загрузки.
Разрешено несколько использований: Нет.
Целевое назначение вывода: Запись в целевое назначение журнала ошибок по умолчанию.
Поддержка Performance Schema: Запись в таблицу error_log. Предоставляет парсер для чтения файлов журнала ошибок, созданных предыдущими экземплярами сервера.

Компонент log_sink_json

Назначение: Реализует протоколирование ошибок в формате JSON. См. раздел 7.4.2.7, «Протоколирование ошибок в формате JSON».
URN: file://component_log_sink_json
Разрешено несколько использований: Да.
Целевое назначение вывода: Этот сток определяет целевое назначение вывода на основе целевого назначения журнала ошибок по умолчанию, указанного системной переменной log_error:
- Если log_error задаёт имя файла, сток формирует имя файла вывода на основе этого имени файла, плюс добавляется порядковый .NN.json суффикс, начиная с NN 00. Например, если log_error есть file_name, последующие экземпляры log_sink_json, указанные в значении log_error_services, записываются в file_name.00.json, file_name.01.json и так далее.
- Если log_error равно stderr, сток записывает в консоль. Если log_sink_json указан несколько раз в значении log_error_services, все они запишутся в консоль, что, вероятно, бесполезно.
Поддержка Performance Schema: Запись в таблицу error_log. Предоставляет парсер для чтения файлов журнала ошибок, созданных предыдущими экземплярами сервера.

Компонент log_sink_syseventlog

Назначение: Реализует протоколирование ошибок в системный журнал. Это Журнал событий в Windows и syslog в системах Unix и Unix-подобных системах. См. раздел 7.4.2.8, «Протоколирование ошибок в системный журнал».
URN: file://component_log_sink_syseventlog
Разрешено несколько использований: Нет.
Целевое назначение вывода: Запись в системный журнал. Не использует целевое назначение журнала ошибок по умолчанию.
Поддержка Performance Schema: Не записывает в таблицу error_log. Не предоставляет парсер для чтения файлов журнала ошибок, созданных предыдущими экземплярами сервера.

Компонент log_sink_test

Назначение: Предназначен для внутреннего использования при написании тестовых случаев, а не для использования в рабочей среде.
URN: file://component_log_sink_test

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