Debug Bundle

A debug bundle is a single JSON file that packages everything support needs to diagnose a GPS or tracking issue — raw data, classifier decisions, trip metadata, and a sanitised copy of your org config. Generating one takes a few seconds and saves a long back-and-forth.

What's inside

  • Raw GPS points received on the selected day(s) — lat, lon, timestamp, altitude, velocity, transport mode, source device.
  • Classifier output — the same points after the transport-mode engine has run, so you can compare what the device sent vs. what the system decided.
  • Trips overlapping the date range — summary preview with distance, modes, max speed, and elevation.
  • GPS source freshness — last received timestamp per source (OwnTracks, Garmin inReach, etc.) so stale sources stand out.
  • Sanitised org config — tokens, credentials, and API keys are stripped. Only display settings, transport thresholds, and feature flags are included.
  • Aggregate counts — mode breakdown post-classifier, velocity min/max, point totals.

How to generate one

  1. Open the org admin sidebar and click Support.
  2. Scroll down to Debug bundle.
  3. Pick a From and To date (max 14-day range). Defaults to today.
  4. Click Generate Debug JSON.

A prompt asks whether to share the bundle to support (opens a pre-filled support ticket with the JSON attached) or download a local copy. You can do both — check the "Also download a local copy" box before confirming.

When to use it

  • A trip is missing GPS points or showing wrong transport modes.
  • The live tracker hasn't updated in a while and you're not sure which source is stale.
  • Support asks for "a debug bundle for yesterday" — this is what they mean.

Privacy

The bundle contains GPS coordinates for the selected date range. It does not include data from other date ranges, other org members' data, or any authentication credentials. Sharing it with support sends it over the same encrypted channel as any other support ticket.

  • Contact support — how to open and track tickets.
  • GPS drift — how the drift filter cleans noisy points before they reach the bundle.

Need help? Contact support · Where Is Tereza?