Live

Real-time view of active visitors and incoming events. Use Live immediately after deploying the SDK to confirm integration before diving into analytics.

Path: /p/:projectId/live

What you’ll see

Panel	Description
Active visitors	Users with events in the last few minutes
World map	Geographic distribution of current visitors
Device breakdown	Desktop vs mobile vs tablet split
Country breakdown	Top countries by active visitor count
Activity feed	Scrolling list of recent events with properties

The page polls the backend on an interval — it is near-real-time, not sub-second streaming. Expect 5–15 seconds of delay between firing an event and seeing it in the feed.

Integration verification workflow

Follow this checklist after every SDK deploy:

Open Live in one browser tab.
Trigger events in your app (navigate pages, click buttons).
Confirm the active visitor count increases.
Confirm events appear in the activity feed with correct names and properties.
Open Events to verify the event catalog updated.


// Quick smoke test from your browser console (after init)
import { track } from '@poluruprvn/pug-web'
track('integration_test', { source: 'manual', timestamp: Date.now() })

Look for integration_test in the activity feed within 15 seconds.

Use cases

Post-deploy verification

After merging an SDK update, open Live on staging and production simultaneously. Trigger the same events and compare feeds to catch environment misconfiguration (wrong API key, wrong endpoint).

Launch-day monitoring

Keep Live open during a product launch. Watch the map and visitor count for traffic spikes. Cross-reference with Overview KPI tiles for aggregate trends.

Marketing-driven spikes

When an email or ad campaign drives traffic, Live shows the immediate response. Compare the activity feed event mix (e.g. page_view vs purchase) against your baseline.

Debugging missing events

If events appear in your browser network tab but not in Live:

Confirm the x-project-id header matches your dashboard project
Check you’re viewing the correct project in the sidebar switcher
Verify the API key is the SDK key (not a revoked or shared key)

Activity feed details

Each feed entry shows:

Event name — e.g. page_view, click, purchase
Timestamp — when the event was received
Key properties — a preview of the property payload
User context — anonymous or identified profile link

Click an event to expand full properties. Click a profile link to open Profiles detail.

Limitations

Not a log viewer — the feed shows recent events, not a searchable history. Use Events or Profiles for full history.
No sub-second latency — polling-based, not WebSocket streaming.
Active visitor window — users inactive for several minutes drop off the count even if their session is technically open.