7.5.3 Error Log Components — MySQL 8.4

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

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

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

Фильтр обрабатывает события журнала, чтобы добавить, удалить или изменить поля событий или полностью удалить события. Результирующие события передаются следующему компоненту журнала в списке включённых компонентов.
Приемник — это пункт назначения (записывающее устройство) для событий журнала. Как правило, приемник обрабатывает события журнала в сообщения журнала, имеющие определенный формат, и записывает эти сообщения в связанный вывод, например, в файл или в системный журнал. Приемник также может записывать в таблицу Performance Schema 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.
Для компонента приемника — пункт назначения, в который компонент записывает вывод.
Для компонента приемника — поддерживает ли он интерфейс к таблице Performance Schema 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, так как, как уже упоминалось, он предназначен для внутреннего использования. Поэтому его поведение может измениться в любое время.