Downloading the Diagnostics Bundle

After the Zoomdata 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 Using the Zoomdata Tracing Microservice.

To 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 Zoomdata instance would be http://localhost:8080, so the Service Monitor URL would be http://localhost:8050. If your Zoomdata instance is at port, the Service Monitor URL would be

    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 Installing and Configuring the Zoomdata Service Monitor.

  3. Click 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 Zoomdata tracing server is not running, the Trace ID box will be disabled, with a relevant error message. When this happens, the diagnostic bundle contains only log files.

  5. Click Download Diagnostic Bundle.

    If you did not specify a trace ID, the zip file that is produced contains only log files for all configured Zoomdata microservices. If you specify a valid trace ID (from a log statement or found using the Zoomdata tracing microservice), the trace JSON file will also be included as part of the bundle. (See Viewing a Trace for tips on identifying a trace ID.)

    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. The Zoomdata tracing microservice does not keep traces forever, and in some cases retention may be as low as a few hours (depending on volume and configuration). Traces are best retrieved as soon as an error is encountered. See Persisting Traces.

    Attempting to retrieve an older trace and receiving "not found" is an expected behavior unless the same trace ID can be retrieved using the Zoomdata tracing microservice UI.

    For more information about the Zoomdata tracing microservices, see Using the Zoomdata Tracing Microservice.