Difference between revisions of "Send Debugging Information"

From MatterControl Manual
Jump to: navigation, search
Line 1: Line 1:
MatterControl occasionally has issues (*gasp*), but there is often information you can collect which might tell us more about what the problem is.
+
MatterControl occasionally has issues (*gasp*), but there is often information you can collect which might tell us more about what the problem is. Send the appropriate files to support@matterhackers.com, or post them in [http://forums.matterhackers.com/ our forum].
  
== Windows ==
+
== Print Log / Terminal Log ==
 +
This log details all the communications between MatterControl and your printer. It is helpful for diagnosing hardware/firmware errors and communications issues.
 +
 
 +
#Run a print as you normally would.
 +
#Once the problem occurs, open the [[Options/G-Code Terminal|G-Code terminal]] by going to Options > Show Terminal.
 +
#Click the 'Export' button at the bottom of the screen.
 +
#Save the print log and send it to support@matterhackers.com.
 +
 
 +
== Event Log ==
 +
This file is helpful for debugging crashes or issues with the MatterControl application itself.
 +
 
 +
=== Windows ===
  
 
The following steps could produce some error logs that might tell us more about what's going on:
 
The following steps could produce some error logs that might tell us more about what's going on:
Line 11: Line 22:
 
#Attach the .evtx file to an email to support@matterhackers.com. Describe the circumstances leading up to the crash.
 
#Attach the .evtx file to an email to support@matterhackers.com. Describe the circumstances leading up to the crash.
  
== Mac ==
+
=== Mac ===
  
 
If you are encountering a crash error on Mac follow the steps described below to generate a report:
 
If you are encountering a crash error on Mac follow the steps described below to generate a report:
Line 24: Line 35:
 
#Send the error message to support@matterhackers.com
 
#Send the error message to support@matterhackers.com
  
== Linux ==
+
=== Linux ===
  
 
Run {{ic|MatterControl}} from a terminal. Copy all output and send it to support@matterhackers.com
 
Run {{ic|MatterControl}} from a terminal. Copy all output and send it to support@matterhackers.com

Revision as of 19:24, 8 March 2016

MatterControl occasionally has issues (*gasp*), but there is often information you can collect which might tell us more about what the problem is. Send the appropriate files to support@matterhackers.com, or post them in our forum.

Print Log / Terminal Log

This log details all the communications between MatterControl and your printer. It is helpful for diagnosing hardware/firmware errors and communications issues.

  1. Run a print as you normally would.
  2. Once the problem occurs, open the G-Code terminal by going to Options > Show Terminal.
  3. Click the 'Export' button at the bottom of the screen.
  4. Save the print log and send it to support@matterhackers.com.

Event Log

This file is helpful for debugging crashes or issues with the MatterControl application itself.

Windows

The following steps could produce some error logs that might tell us more about what's going on:

  1. Right click on ‘My Computer’ and select ‘Manage.’
  2. In the menu on the left, navigate to ‘System Tools’ > ‘Event Viewer’ > ‘Windows Logs’.
  3. Click on ‘Application’ to show logs in the middle window pane, then click ‘Filter Current Log’ in the right window pane, then check ‘Error’ and hit ‘OK’.
  4. In the right window pane, choose ‘Save Filtered Log File As’. Give the file (should be in .evtx format) a descriptive name.
  5. Attach the .evtx file to an email to support@matterhackers.com. Describe the circumstances leading up to the crash.

Mac

If you are encountering a crash error on Mac follow the steps described below to generate a report:

  1. Go to the 'Applications' folder
  2. Locate the MatterControl.app file
  3. Right-click and select "Show Package Contents"
  4. Go to 'Contents' > 'MacOS'
  5. Click the 'MatterControlMac' file (this will start the application and open a terminal window)
  6. If MatterControl crashes upon startup copy the message that appears in the terminal window immediately
  7. If the crash is triggered by a specific event, recreate the event and then copy the message that appears
  8. Send the error message to support@matterhackers.com

Linux

Run MatterControl from a terminal. Copy all output and send it to support@matterhackers.com