MicroStrategy ONE

Automated Crash Report and Diagnostics Configuration

The Intelligence Server uses the crash_report.ini file to configure the Automated Crash Reporting and Diagnostics Tool behavior, which is under the current working directory. Below is the default location:

  • Windows: C:\Program Files (x86)\MicroStrategy\Intelligence Server

  • Linux: /opt/mstr/MicroStrategy/IntelligenceServer/crash_report.ini

The crash_report.ini file

The crash_report.ini configuration file has two sections as shown below:

Copy
[Config]
ServerURL=https://submit.backtrace.io/microstrategy/35d272ef647f8ec00f3560749e6457bb7a131fed4418f9b48adad8e113e0dca8/minidump

ServerProdURL=https://submit.backtrace.io/microstrategy/35d272ef647f8ec00f3560749e6457bb7a131fed4418f9b48adad8e113e0dca8/minidump
dump_path=crash_dumps
enable=truediagnostics=true
native_dump=true
keep_dump_file=true

[CrashAttachments]
DSSErrors.log=true
cubehealthchecker.log=true

How to disable the Automated Crash Reporting and Diagnostics Tool

The Automated Crash Reporting and Diagnostics Tool is enabled by default when installing MicroStrategy. To disable:

  1. Open the crash_report.ini file in a text editor.

  2. In the [Config] section of the file:

    • To disable crash reporting, set the enable parameter to false as shown below.

    • To disable diagnostics reporting, set the diagnostics parameter to false as shown below.

      This configuration is available starting in MicroStrategy 2021 Update 5.

  3. Save the crash_report.ini file.

  4. Restart the Intelligence Server to apply the changes.

How to manually upload the mini dump file to MicroStrategy

The Automatic Crash Reporting and Diagnostics Tool will automatically upload results to a remote server for analysis. Should it be necessary to manually upload a crash report to MicroStrategy, perform the following steps:

  1. Copy the dump file to a machine with outbound communication enabled on port 443.
  2. Open a Command Line/Terminal and enter the following command:

    Copy
    curl -X POST -F "upload_file_minidump=@<dump_file_path>" -F "customer_dsi=<dsi>" -F "attachment_DSSErrors.log=@<dsserrors_log_path>" <ServerProdURL>
    • <dump_file_path> is the path to the copied dump file.
    • <dsi> is the customer identifier.
    • <dsserrors_log_path> is the path to your DSSErrors.log file. This is optional and you can remove the -F "attachment_DSSErrors.log=@<dsserrors_log_path>" argument to exclude DSSErrors.log.
    • <ServerProdURL> is the value of key 'ServerProdURL' in the crash_report.ini configuration file.

    Windows Example

    Copy
    curl -X POST -F "upload_file_minidump=@C:\Program Files (x86)\MicroStrategy\Intelligence Server\crash_dumps\ABCDEFG.dmp" -F "customer_dsi=1234" -F "attachment_DSSErrors.log=@C:\Program Files (x86)\Common Files\MicroStrategy\logs\DSSErrors.log" https://submit.backtrace.io/microstrategy/<token_id>/minidump

    Linux/MacOS Example

    Copy
    curl -X POST -F "upload_file_minidump=@/var/opt/MicroStrategy/IntelligenceServer/crash_dumps/ABCDEFG.dmp" -F "customer_dsi=1234" -F "attachment_DSSErrors.log=@/var/log/MicroStrategy/DSSErrors.log" https://submit.backtrace.io/microstrategy/<token_id>/minidump
  3. If successful, you receive a 200 response:

    {"response":"ok","_rxid":"68000000-cde8-6f03-0000-000000000000"}