Skip to main content

Diagnostics Bundles For Support

Diagnostics bundles are device archives stored on the device. They are useful when diagnosing failures or filing issues.

Goal​

You are done when:

  • You have a downloaded diagnostics bundle.
  • You can share it with support along with a short description of the failure.

When To Capture A Diagnostics Bundle​

Capture one as close to the failure as possible.

Good times to capture:

  • Right after an update, if something feels off.
  • Right after a camera starts flapping or fails to open.
  • Right after a pipeline refuses to run or outputs go empty.
  • Right after a reboot if the system does not return to a healthy state.

Capture (UI)​

  1. Open Settings > Diagnostics.
  2. (Optional) set a label that describes the moment ("after update", "camera flapping", etc).
  3. Click Capture diagnostics bundle.

What you should see:

  • A new entry in the diagnostics bundle list with a timestamp and your label.

Download​

  1. In the bundle list, click download.
  2. Keep the filename.

Retention (Do Not Fill The Disk)​

Diagnostics bundles take disk space. Configure retention:

  • retention count
  • max size (MiB)
  • tar.gz vs directory

If you are doing repeated testing, keep retention low so the device does not fill its storage.

What To Include With A Diagnostics Bundle​

  • what you expected
  • what happened
  • the device model and attached peripherals
  • a short time window
  • an Alerts export (optional but useful)

If you already have Alerts open, export it first and include it with the bundle:

See: