New aggregated insights just released Learn more →

Enable debug mode and read event stream

Use live diagnostics to troubleshoot ingestion and conversions

Written by Trace Team Updated 14-04-26

What debug mode helps with

  • Confirming whether events are reaching Trace.
  • Understanding event type/status in real time.
  • Isolating install, consent, or conversion trigger issues.

Enable debug mode

  1. Open a site route in the dashboard.
  2. Append ?debug=true to the URL.
  3. Open debug sidebar/console.
  4. Trigger test events on your site.

How to use the stream

  • Watch for incoming events and status transitions.
  • Filter by event type to isolate one problem area.
  • Match timestamps with your browser/network activity.

Recommended workflow

  1. Trigger one known action at a time.
  2. Confirm it appears in debug stream.
  3. If missing, inspect script install and consent state.
  4. If present but not reporting correctly, inspect conversion configuration.

Troubleshooting

  • No stream events at all: verify site selection and debug mode URL.
  • Only heartbeat/system entries: snippet may be loaded but not firing expected events.
  • Events appear with errors: inspect payload shape and conversion mapping rules.

Still need help?

Contact our support team and we will get back to you as soon as we can.

support@usetrace.io