Attaching Sugar logs to tickets

From OLPC
Revision as of 10:36, 3 October 2008 by Skierpage (talk | contribs) (→‎Enabling debugging: press Enter, link X)
Jump to navigation Jump to search

If you provide debugging logs to a ticket, you'll be making it much easier to developers to fix the issue.

Enabling debugging

These are general steps to follow when providing logs for some bug:

 echo 'export SUGAR_LOGGER_LEVEL=debug' >> /home/olpc/.xsession
then press the Enter key
  • Reboot, or just restart X using ctrl+alt+erase
  • Perform the minimal steps to reproduce the bug.
  • From a terminal window, type:
 sudo olpc-log
  • It places all relevant logs into a file in the current directory. The name of the file includes the serial number of the laptop and the date and time the log was generated. Please send this log when reporting the problem.
  • Log is an activity for viewing log files

Other debugging settings

The file /home/olpc/.xsession-example contains other settings useful for debugging, you can copy individual lines from this or copy the entire file to /home/olpc/.xsession, and uncomment the debug logging lines as needed.

Presence service

If your bug involves the presence service, you might also want to follow the steps for Telepathy debugging.

If you can't reproduce the bug

Python-based activities automatically make logs in /home/olpc/.sugar/default/logs. These logs seem to be moved into subfolders on restart and deleted after a certain period of time. The python stack trace is recorded here on crashes. This is also a good thing to attach to a bug. As above, you will have to use the Terminal activity to copy them to removable memory (SD or USB) before using the XO or another computer to attach them to the bug.