Skip to main content
To open a support ticket, navigate to: https://central.insightsoftware.com.

​
Diagnose Problems

Self-Service Analytics provides a “one-click” diagnostics bundle for the Self-Service Analytics platform as part of the Self-Service Analytics Service Monitor. The diagnostics bundle is primarily useful as an easy way to send insightsoftware the information needed to help you debug a problem. The bundle is a zip file containing all the current log files from all Self-Service Analytics’s microservices. If distributed tracing is enabled and properly configured, the diagnostics bundle may also contain a JSON trace file with the trace ID you specify. An example of the uncompressed contents of the diagnostic bundle might look like this:

​
Prerequisites

Before you can download the diagnostics bundle, the following conditions must be met: After the Service Monitor is installed, you can download the diagnostics bundle. See Download the Diagnostics Bundle.

​
Download the Diagnostics Bundle

After the Service Monitor microservice is installed and running, you can use it to download a diagnostic bundle. If you want to include trace details in the diagnostics bundle, be sure to collect tracing information as described in Distributed Tracing for Self-Service Analytics. Download a diagnostics bundle
  1. Using a web browser, navigate to the Service Monitor. Its default port is 8050. For example, if running locally, the Self-Service Analytics instance would be http://localhost:8080, so the Service Monitor URL would be http://localhost:8050. If your instance is at port 10.2.3.24, the Service Monitor URL would be http://10.2.3.24:8050. A login screen will appear.
  2. Log into the Service Monitor using the Service Monitor user name and password you defined when the Service Monitor was installed. See Install and Configure the Self-Service Analytics Service Monitor.
  3. Select Downloads on the main menu bar. A screen appears that you can use to download the diagnostics bundle:
  4. Optionally enter a trace ID in the Trace ID box. If the tracing service is not configured, the Trace ID box will be disabled, with a relevant error message. When this happens, the diagnostic bundle contains only log files.
  5. Select Download Diagnostic Bundle. If you did not specify a trace ID, the zip file that is produced contains only log files for all configured Self-Service Analytics microservices. If you specify a valid trace ID, the trace JSON file will also be included as part of the bundle. If you specify an invalid trace ID, a relevant error message displays. In some cases, a previously valid trace ID may be reported as not found. Traces are best retrieved as soon as an error is encountered. For more information about distributed tracing microservices, see Distributed Tracing for Self-Service Analytics.