Knowledgebase:
Submitting Diagnostic Reports
Posted by Matthew Yetter, Last modified by Matthew Yetter on 18 February 2020 04:04 PM
Any software can crash or encounter other issues, and those that push your computer's resources hard are especially likely to have this happen.  Pixologic takes great care to make our software as stable as possible but there is no way to prevent these problems altogether.  

With ZBrush 2020.1 we have introduced a Support utility called the ZBrush Diagnostic Utility.  (Downloaded from here and once installed, located in your highest version ZBrush installation's Troubleshoot Help folder.)  This tool is meant to help Pixologic determine exactly what might have caused your issue or crash, allowing us to better help with certain types of Support tickets.  The information gathered can potentially lead to changes in future releases that prevent the issue from recurring for all users.  It is especially valuable with crashes that seem to happen for no apparent reason.  As we compare reports from various users we can look for patterns that can lead to finding a solution or developing preventive measures.

We recommend that you provide a diagnostic report with any Support ticket where you believe you are encountering bug, are experiencing frequent and unpredictable crashes, etc.  If you do not include a report with your ticket and the Support team feels that it will be of use, we will request that you do so before we attempt to assist you further.

What a Report Includes
Pixologic takes customer data privacy very seriously.  We are therefore very selective about what information is included in a crash report.  We also want you to know what that info is so that you can feel comfortable when submitting your report.  Additionally, we do not share customer data -- including diagnostic reports -- with any third parties.  Your report is strictly between you and Pixologic.  

We do not actively monitor your computer.  The Support Utility only launches when you specifically request it, at which point it collects the data that will be submitted.  Nothing at all is sent to Pixologic until you actually submit the report via the dedicated web page.  This means that you can opt out of the reporting system by simply not submitting any report.  (We would be greatly appreciative if you did submit it, however!  And of course there are some tickets where we will be unable to assist if you do not provide the report.)  

Also, the default report does not include any personal data whatsoever. Submitting a diagnostic report will not subscribe you to our newsletter or set you up to receive any other marketing emails.

Information included automatically:
  • ZBrush version number
  • ZBrush directory (installation) location
  • Computer name
  • Operating system (Windows or macOS)
  • Operating system version number
  • CPU model
  • CPU cores
  • Total RAM
  • Virtual Memory path
  • QuickSave path
  • An inventory of inconsistencies in your ZBrush directory.  This does not tell us everything that is in your ZBrush folders.  It only looks at the files that are essential for ZBrush to function and changes made within the ZStartup folder.  Even there, it will only mention a file if one of the following is true:
    • A required file is not present.
    • A file has been added since installing ZBrush.
    • A required file is the incorrect size.

After the utility has finished gathering the necessary information, it creates a text file in your ZBrushData2020\support folder.  It then opens that folder so that you can easily access the report.

To Submit Your Report:

Simply submit a Support ticket or (if one is already in progress) reply to your existing ticket.  

Be sure to attach the file generated by the diagnostic utility.

Note: If your computer does not have internet access, please copy the diagnostic report to a USB stick or other portable media.  Take that to a computer that does have internet access.  


Thank you for using ZBrush!