Enable debug mode and read event stream
Updated 30 September 2026
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
- Open a site route in the dashboard.
- Append
?debug=true to the URL.
- Open debug sidebar/console.
- 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
- Trigger one known action at a time.
- Confirm it appears in debug stream.
- If missing, inspect script install and consent state.
- 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.
Was this useful?