Skip to content
tracing.toolstracing.tools

Realtime

/dashboard/<siteId>/realtime — the screen to open when you have just installed the tracker, or just shipped something.

Windows

Section titled “Windows”

Realtime does not use the range picker. Every figure has its own fixed window, and they are deliberately different:

Element Window
Online now distinct visitors in the last 5 minutes
Pageviews / min pageviews in the last 1 minute
Events last hour every event in the last 1 hour
Visitors chart one point per minute for the last 30 minutes
Event feed the most recent 30 events from the last 30 minutes
Breakdown panels the last 30 minutes, top 6 rows each

The chart is zero-filled minute by minute, so a quiet minute is a zero.

The feed

Section titled “The feed”

Newest first, one row per event, with the path, the event name where there is one, the country, the browser and the device. It updates in place; if you have scrolled down and new events arrive, a Show newer events button appears rather than yanking the list.

Polling

Section titled “Polling”

The page polls GET /api/realtime/<siteId> every 5 seconds. Polling pauses automatically while the tab is hidden, and there is a Pause button for when you want to read a row without it moving.

If three polls in a row fail — 15 seconds without a successful response — the status word changes to Reconnecting. It recovers on its own.

Breakdowns

Section titled “Breakdowns”

Three panels — Pages, Referrers, Countries — over the same 30 minutes, six rows each.

Using it to verify an install

Section titled “Using it to verify an install”
  1. Load your site in a normal browser tab — not localhost, unless you have set tracing_debug.
  2. Online now should reach 1 within about five seconds.
  3. Your path should appear in the feed.

If it does not, work through Opt-out & debugging.

URL parameters

Section titled “URL parameters”

None. The topbar hides the range picker and the export button on this screen.

Section titled “Related”