Home / Reference / Bugs

Using System Reports to collect crash information

The System Reports tool automatically gathers useful data when an application crashes. This information can be critical in fixing the bug that caused the crash.

Launching

1) From your desktop’s start menu, launch the System Reports tool:

Mint Report initial window

2) Select Crash reports from the sidebar:

Crash reports selected

3) Select the application entry in the crash list:

Individual report selected

ℹ️ Note: Many Linux Mint tools are written in Python, so you may see python listed as the application that crashed, instead of your application’s name. In these cases try to match the time of the crash listed with the time you experienced the issue.

4) Click the Local Files button, this will open your file browser to the location where this crash’s information is stored:

Click local files

In the directory you’ll find a file named crash.tar.gz - this contains all of the available information on this crash, which could prove invaluable to a developer trying to fix it. If you want to see what this information is, you can have a look at the crash folder:

5) Upload crash.tar.gz:

The easiest way to make this file available is to attach it to a comment in a Github issue. You should be able to drag-and-drop the file right into the comment section.

Drag into issue

You can also use the ‘attach’ button:

Attach button

ℹ️ Note: Github does not allow files larger than 25MB to be uploaded. If your crash report is larger than this, you can use a service like transfer.sh to upload the file, and then paste the link into the issue. Cloud storage services can also be used here, such as Dropbox and Google Drive.

That’s it!