Event Debugger

Live event stream for debugging instrumentation

The Event Debugger shows a real-time stream of events flowing into your project. Use it to verify your tracking implementation, debug missing properties, and confirm events are firing correctly.

Accessing the debugger

Navigate to /{projectId}/debugger in the dashboard app, or click Event Debugger in the sidebar under Tools.

Features

FeatureDescription
Live/Pause toggleStart and stop the event stream without losing buffered events
Event type filtersClick event name badges to filter the stream by type
Expandable propertiesClick any event row to expand its full JSON properties
Geo dataShows country and city from Cloudflare geo enrichment
Rolling bufferKeeps the last 200 events with automatic deduplication

How it works

The debugger polls the /api/events endpoint every 3 seconds, which queries the recent_events Tinybird pipe for events from the last 5 minutes. Events are deduplicated by timestamp and event name to avoid duplicates across polls.

// The polling hook
const { events, isLive, toggleLive, clear } = useEventStream(projectId)

// Each event contains:
{
  event: "signup_completed",
  timestamp: "2026-02-05T12:34:56.789Z",
  distinct_id: "user_abc123",
  session_id: "sess_xyz",
  properties: '{"plan": "pro", "source": "google"}',
  country: "US",
  city: "San Francisco"
}

Tip

Open the debugger in one tab and your app in another. As you interact with your app, events appear in the debugger in real time.

Next Steps