Appendix C Reporting A Useful MySQL Workbench Bug

The following is a list of tips and information that is helpful for reporting a MySQL Workbench bug.

A useful bug report includes:

Bugs that cannot be reproduced are difficult and nearly impossible to fix, so it is important to provide the steps necessary to reproduce the bug.

Where to report a bug

Visit http://bugs.mysql.com/ and use one of the "MySQL Workbench" bug categories.

Log Levels

There are six different log levels, with increasing levels of verbosity: error, warning, info, debug1, debug2, and debug3. By default, the error, warning and info levels are enabled. There is also a "none" level that completely switches off logging.

Important

Please enable the debug3 level before generating a log for the report.

The enabled error log levels can be configured using an environment variable, or by using a command line parameter.

Both the environment variable and command line variants accept a single error level, but enabling a more verbose option will implicitly enable the levels below it. For example, passing in "info" will also enable the "error" and "warning" levels.

Note

If both the command line and environment variable are set, the command line takes precedence.

For example:

  
# Microsoft Windows
shell&gt; <userinput>cd "C:\Program Files (x86)\MySQL\MySQL Workbench CE 6.0.9\"</userinput>
shell&gt; <userinput>MySQLWorkbench.exe -log-level=debug3</userinput>

# Mac OS X
shell&gt; <userinput>cd /Applications</userinput>
shell&gt; <userinput>MySQLWorkbench --log-level=debug3</userinput>

# Linux (Ubuntu)
shell&gt; <userinput>cd /usr/bin</userinput>
shell&gt; <userinput>mysqlworkbench --log-level=debug3</userinput>
  
  

If the info level is enabled, the system information and all paths used in the application are also logged. On Microsoft Windows, this also means that the log file contains the full set of current environment variables that are active for the program.

Operating System Specific Notes

Microsoft Windows

Mac OS X

Linux