Skip to content

Live stream

The Live stream tails events as they reach leadmaps, newest at the top. It is the most immediate view in the product. The stream starts from an exact list snapshot, resumes from an opaque cursor, and suppresses duplicate event IDs after a reconnect.

Think of it like standing at the arrivals gate of an airport. You are not searching a schedule. You are watching people walk through the door in real time as their planes land.

  • A page title that reads “Live stream”.
  • The stream itself: a live list of events pushed to your screen as they arrive, newest at the top. Each entry names the event, shows when it happened, which privacy-aware actor it belongs to, and its key details. The browser keeps a sliding window of the newest 200 events.
  • Event-type chips and an anonymous visitor ID filter. Both reconnect the server stream with the filter applied instead of hiding unrelated events only after download.
  • Pause, resume, and clear controls.
  • A connection state that distinguishes live, reconnecting, offline, and paused. When your site is quiet, the stream simply waits for the next event.

Open it and watch. That is the whole idea.

Here is a worked example. You have just installed leadmaps on your site and you want to be sure it is working before you trust any report. You open the Live stream on one screen and your own site on another. You click around your site: open a page, click a button, submit a form. Within a second, each of those actions shows up as a fresh entry at the top of the stream. Now you know, with your own eyes, that tracking is live and events are flowing. No waiting, no guessing.

If you click around your site and nothing appears in the stream, that is the clearest possible signal that the tracking snippet is not installed or not running on the page you are testing. That is exactly the kind of thing the Live stream is built to catch in seconds.

  • Focus on one visitor. Narrow the stream to a single person so you can follow only their actions as they happen. This is useful when you are testing as yourself and want to ignore everyone else’s traffic on a busy site.
  • Filter by event type. Pick a type chip to watch only pageviews, purchases, or another event already seen in this stream.
  • Pause or clear. Pause keeps the current rows still while you inspect them. Clear removes the local sliding window without deleting stored analytics.

The Live stream is deliberately simple. When you want to search back through past events, filter by source, or study totals, use the Events feed and the report pages instead.

  • Prove tracking works right after install. Open the Live stream, then click around your own site. Action: if your clicks appear within a second, leadmaps is installed correctly and you can trust the reports. If nothing appears, fix the snippet on your site first.
  • Test a new button or form live. Open the stream, focus it on yourself, then use the button or form you just built. Action: watch the event land in real time and confirm it carries the right details, so you catch a broken event before real visitors hit it.
  • Sanity-check a busy launch. During a launch or campaign, open the stream to feel the pulse of activity. Action: a steady flow of events means things are working. A sudden silence during a moment you expect traffic is a warning worth chasing down.
  • The Live stream is for right now, not a complete historical export. To look back across a date range or inspect exact totals, use the Events page.
  • Reconnecting does not mean the event history was discarded. The client resumes from the last acknowledged cursor and the Events page continues polling its exact snapshot as a reconciliation path.
  • No events during a quiet moment is normal. The stream only moves when your site is being used. Silence at 3 a.m. on a small site is expected, not a fault.
  • It is the fastest way to answer “is my tracking working?”. When in doubt after any change to your site, open the Live stream and click around. Seeing your own actions appear is the most direct proof there is.