Appendix D How To Report Bugs or Problems — MySQL Workbench

Приложение D Как сообщать об ошибках или проблемах

Ниже приведен список советов и информации, которая полезна для сообщения об ошибке MySQL Workbench.

Полезное сообщение об ошибке включает:

Точные шаги, предпринятые для воспроизведения ошибки, в идеале в виде видео, если ошибка трудно воспроизводится.
Скриншот, если ошибка визуальная.
Сообщения об ошибках, включая текст, отправленный в stdout и графический интерфейс.
Копию файла журнала MySQL Workbench.

Расположение файла журнала можно найти, используя Справка, Найти файлы журналов в MySQL Workbench.

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

Куда сообщать об ошибке

Посетите http://bugs.mysql.com/ и воспользуйтесь одной из категорий ошибок.

Уровни журналов

Существует шесть различных уровней журналов с возрастающей степенью подробности: error, warning, info, debug1, debug2 и debug3. По умолчанию включены уровни error, warning и info. Также существует уровень none, который отключает ведение журнала.

Важно

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

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

Переменная окружения, параметр командной строки и параметр настроек принимают один уровень ошибок, но включение более подробного варианта неявно включает уровни ниже него. Например, передача info также включает уровни error и warning.

Переменная окружения: WB_LOG_LEVEL

Параметр командной строки: --log-level

Примечание

Если оба параметра (командной строки и переменной окружения) установлены, приоритет имеет параметр командной строки.

Например:

# Microsoft Windows
$> cd "C:\Program Files (x86)\MySQL\MySQL Workbench CE 8.0.41\"
$> MySQLWorkbench.exe --log-level=debug3

# macOS
$> cd /Applications
$> MySQLWorkbench --log-level=debug3

# Linux (Ubuntu)
$> cd /usr/bin
$> mysqlworkbench --log-level=debug3

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

Примечания, специфичные для операционной системы

Microsoft Windows

Расположение файла журнала: в папке данных приложения пользователя, например, C:\Users\[user]\AppData\Roaming\MySQL\Workbench\log для Microsoft Windows 10.
В случае ошибок (или исключений) файл журнала содержит стек вызовов до момента, когда MySQL Workbench может отследить его (обычно только код C#, а не C++). Также все предупреждения добавляются в журнал, если включен уровень предупреждения (или выше) журнала.
Если произошел сбой, который невозможно воспроизвести командой MySQL Workbench, и стек вызовов получить не удается, мы запросим дамп сбоя. Инструкции по включению дампов сбоев можно найти здесь, а также ознакомьтесь с подробностями MSDN, так как нам нужен полный дамп, а не мини-дамп.
В случае сбоев, связанных с отображением, запустите MySQL Workbench с параметром -swrendering (и только тогда, так как он отключает рендеринг OpenGL, который бесполезен в WBA или WQE). Этот вывод будет добавлен в файл журнала.
Если произошел сбой при запуске MySQL Workbench (особенно если отчет об ошибке содержит что-то о kernelbase.dll), мы попросим вас запустить depends.exe на MySQLWorkbench.exe бинарнике и запросим сообщения об ошибках.
Если произошел сбой при запуске MySQL Workbench, и это 64-разрядная версия Microsoft Windows, убедитесь, что установлены правильные среды выполнения MSVC. Часто люди устанавливают 64-битную версию, но работать будет только 32-битная.

macOS

Расположение файла журнала: ~/Library/Application Support/MySQL/Workbench/logs
Журналы сбоев системы, созданные для Workbench, находятся в ~/Library/Logs/DiagnosticReports/MySQLWorkbench*

Linux

Расположение файла журнала: ~/.mysql/workbench/log
В случае сбоя мы можем запросить стек вызовов, который можно получить с помощью gdb, выполнив следующие шаги:

Примечание

Так как опубликованные сборки MySQL Workbench не содержат символов отладки, этот шаг необязателен и, вероятно, не потребуется.
- В оболочке выполните source /usr/bin/mysql-workbench
- Закройте MySQL Workbench
- В оболочке выполните gdb /usr/bin/mysql-workbench-bin
- В интерфейсе gdb введите run
- В MySQL Workbench повторите сбой
- В интерфейсе gdb введите bt
Если произошел сбой, также выполните glxinfo. Если и это приведет к сбою, то это проблема драйвера/сервера X, связанная с OpenGL, которая не специфична для MySQL Workbench.