Плагин отзывов

Плагин feedback предназначен для сбора и, при необходимости, отправки конфигурационной и статистической информации о работе в MariaDB.org или любой другой заданной URL.

Плагин feedback присутствует во всех версиях MariaDB.

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

Установка плагина

Хотя общая библиотека плагина поставляется с MariaDB по умолчанию, сам плагин не устанавливается по умолчанию. Существуют два способа установки плагина с MariaDB.

Первый способ позволяет установить плагин без перезапуска сервера. Вы можете установить плагин динамически, выполнив INSTALL SONAME или INSTALL PLUGIN. Например:

INSTALL SONAME 'feedback';

Второй метод позволяет указать серверу загрузить плагин при запуске. Плагин можно установить таким образом, указав --plugin-load или --plugin-load-add опции. Это можно указать как аргумент командной строки для mysqld или в соответствующей группе опций сервера в файле опций группы опций в файле опций. Например:

[mariadb]
...
plugin_load_add = feedback

Удаление плагина

Вы можете удалить плагин динамически, выполнив UNINSTALL SONAME или UNINSTALL PLUGIN. Например:

UNINSTALL SONAME 'feedback';

Если вы установили плагин, указав --plugin-load или --plugin-load-add опции в соответствующей группе опций сервера в файле опций группы опций в файле опций, то эти опции должны быть удалены, чтобы предотвратить загрузку плагина при следующем запуске сервера.

Активация плагина

Вы можете активировать плагин, установив feedback значение ON в соответствующей группе опций сервера в файле опций группы опций в файле опций. Например:

[mariadb]
...
feedback=ON

В Windows плагин также может быть активирован во время новой установки MSI. Установка MSI GUI предоставляет флажок "Активировать плагин отзывов" для активации плагина. Установка MSI с помощью командной строки предоставляет опцию командной строки FEEDBACK=1 для активации плагина.

См. следующий раздел, чтобы проверить, установлен и активен ли плагин, и (при необходимости) установить его.

Проверка статуса плагина

Чтобы проверить, установлен и активирован ли плагин feedback, выполните оператор SHOW PLUGINS или запросите таблицу information_schema.plugins. Например:

SELECT plugin_status FROM information_schema.plugins 
  WHERE plugin_name = 'feedback';

Если запрос SELECT не возвращает строк, то вам необходимо установить плагин.

Когда плагин установлен и активирован, вы увидите:

SELECT plugin_status FROM information_schema.plugins 
  WHERE plugin_name = 'feedback';
+---------------+
| plugin_status |
+---------------+
| ACTIVE        |
+---------------+

Если вы видите DISABLED вместо ACTIVE, то вам необходимо активировать плагин.

Сбор данных

Плагин feedback будет собирать:

• Определенные строки из SHOW STATUS и SHOW VARIABLES.
• Все установленные плагины и их версии.
• Системную информацию, такую как количество процессоров, память, архитектура и дистрибутив ОС/Linux.
• feedback_server_uid, который представляет собой SHA1 хэш MAC-адреса первого сетевого интерфейса и TCP-порта, на котором сервер прослушивает.

Плагин feedback создаёт таблицу FEEDBACK в базе данных INFORMATION_SCHEMA. Чтобы увидеть данные, собранные плагином, вы можете выполнить:

SELECT * FROM information_schema.feedback;

Только содержимое этой таблицы отправляется на feedback_url.

MariaDB сохраняет статистику использования кодировок. Каждая используемая сервером кодировка будет иметь запись в результате "SELECT * FROM information_schema.feedback", например:

+----------------------------------------+---------------------+
| VARIABLE_NAME                          | VARIABLE_VALUE      |
+----------------------------------------+---------------------+
| Collation used utf8_unicode_ci         | 10                  |
| Collation used latin1_general_ci       | 20                  |
+----------------------------------------+---------------------+

Кодировки, которые не использовались, не будут включены в результат.

Отправка данных

Плагин feedback отправляет данные с помощью запроса POST на любой URL или список URL, который вы указываете, установив системную переменную feedback_url. По умолчанию, она установлена на следующий URL:

• https://mariadb.org/feedback_plugin/post

Поддерживаются протоколы HTTP и HTTPS.

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

Если системная переменная feedback_url не установлена на пустую строку, плагин автоматически отправит отчет на все URL в списке через несколько минут после запуска сервера и затем один раз в неделю.

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

Сначала сгенерируйте файл отчета с помощью командной строки MariaDB mariadb:

$ mariadb -e 'select * from information_schema.feedback' > report.txt

Затем вы можете загрузить сгенерированный report.txt файл здесь с помощью вашего веб-браузера.

Или вы можете сделать это из командной строки с помощью таких инструментов, как curl. Например:

$ curl -F data=@report.txt https://mariadb.org/feedback_plugin/post

Ручная загрузка позволяет быть абсолютно уверенным, что мы получаем только данные, показанные в таблице INFORMATION_SCHEMA.FEEDBACK, и что никакая личная или конфиденциальная информация не отправляется.

Версии

Системные переменные

feedback_http_proxy

• Описание: Прокси-сервер для использования, когда HTTP-вызовы не могут быть выполнены, например, в среде с брандмауэром. Формат: host:port.
• Командная строка: --feedback-http=proxy=value
• Только для чтения: Да
• Тип данных: строка
• Значение по умолчанию: '' (пустое)

feedback_send_retry_wait

• Описание: Время в секундах, прежде чем повторно попытать отправку, если плагин не смог отправить данные по какой-либо причине.
• Командная строка: --feedback-send-retry-wait=#
• Область действия: Глобальная
• Динамическая: Да
• Тип данных: числовое
• Значение по умолчанию: 60
• Допустимые значения: 1 до 86400

feedback_send_timeout

• Описание: Попытка отправки данных завершается ошибкой по таймауту через указанное количество секунд.
• Командная строка: --feedback-send-timeout=#
• Область действия: Глобальная
• Динамическая: Да
• Тип данных: числовое
• Значение по умолчанию: 60
• Допустимые значения: 1 до 86400

feedback_server_uid

• Описание: Автоматически вычисляемый хеш уникального идентификатора сервера.
• Область действия: Глобальная
• Динамическая: Нет
• Тип данных: строка

feedback_url

• Описание: URL, на который отправляются данные. Можно указать несколько URL, разделенных пробелами. Установите пустую строку, чтобы отключить отправку данных.
• Командная строка: --feedback-url=url
• Область действия: Глобальная
• Динамическая: Нет
• Тип данных: строка
• Значение по умолчанию: https://mariadb.org/feedback_plugin/post

feedback_user_info

• Описание: Значение этой опции не используется плагином, но включается в данные обратной связи. Его можно использовать для добавления любой строки, указанной пользователем, в отчет. Это может помочь в идентификации, например, номер контракта поддержки или имя компьютера (если вы собираете отчеты в локальной среде, указав ваш собственный feedback-url).
• Командная строка: --feedback-user-info=string
• Область действия: Глобальная
• Динамическая: Нет
• Тип данных: строка
• Значение по умолчанию: Пустая строка

Опции

feedback

• Описание: Определяет, как сервер должен обращаться с плагином при запуске.
  • Допустимые значения:
    • OFF — Отключает плагин, не удаляя его из таблицы mysql.plugins.
    • ON — Включает плагин. Если плагин не может быть инициализирован, сервер продолжит запуск, но плагин будет отключён.
    • FORCE — Включает плагин. Если плагин не может быть инициализирован, сервер не запустится и выдаст ошибку.
    • FORCE_PLUS_PERMANENT — Включает плагин. Если плагин не может быть инициализирован, сервер не запустится и выдаст ошибку. Кроме того, плагин нельзя будет удалить с помощью UNINSTALL SONAME или UNINSTALL PLUGIN во время работы сервера.
  • Дополнительную информацию см. в разделе Обзор плагинов: Настройка активации плагина при запуске сервера.
• Командная строка: --feedback=value
• Тип данных: enumerated
• Значение по умолчанию: ON
• Допустимые значения: OFF, ON, FORCE, FORCE_PLUS_PERMANENT