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:
[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:
-
Open the crash_report.ini file in a text editor.
-
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.
-
-
Save the crash_report.ini file.
-
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:
- Copy the dump file to a machine with outbound communication enabled on port 443.
-
Open a Command Line/Terminal and enter the following command:
Copycurl -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 yourDSSErrors.log
file. This is optional and you can remove the-F "attachment_DSSErrors.log=@<dsserrors_log_path>"
argument to excludeDSSErrors.log
.<ServerProdURL>
is the value of key 'ServerProdURL' in thecrash_report.ini
configuration file.
Windows Example
Copycurl -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
Copycurl -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
-
If successful, you receive a 200 response:
{"response":"ok","_rxid":"68000000-cde8-6f03-0000-000000000000"}