Live Tail
Live Tail streams your log events in real time as they arrive — no refreshing, no polling. Events appear within milliseconds of being ingested.
What you’ll need
- Events actively flowing into your project
- A modern browser (Live Tail uses WebSockets)
Step 1: Open Live Tail
Click Live Tail in the left sidebar.
The page starts in a paused state. You’ll see a start button and filter controls at the top.
Step 2: Start the stream
Click Start to connect to the real-time stream.
Log events will begin appearing as they arrive, newest at the top. Each row shows:
- Time — the exact timestamp (updated live)
- Level — color-coded: error (red), warn (yellow), info (green), debug (gray)
- Service — which service sent the event
- Message — the log message
The stream is updated live — you don’t need to scroll or refresh.
Step 3: Apply filters
Use the filter controls to narrow the stream:
- Level — show only
error,warn,info, ordebug - Service — filter to events from a specific service
- Environment — show only
production,staging, etc.
Filters apply immediately to new events arriving after you set them. Events already visible in the list are not retroactively filtered.
Tip: During a production incident, set Level to
errorand watch for new error patterns appearing in real time.
Step 4: Pause the stream
Click Pause to freeze the list and inspect events without new ones pushing them down.
While paused, events continue accumulating in the buffer. Click Resume to see the latest events (the buffer will be flushed).
Step 5: Clear and restart
Click Clear to empty the visible list and start fresh. The WebSocket connection stays open — new events will continue to arrive.
This is useful after a deploy when you want a clean view of what’s happening post-release.
Step 6: Click an event for detail
Click any row to open the full event detail in a side panel — the same detail view as Log Explorer, with all metadata fields, event ID, and fingerprint.
You’re done
You now know how to:
- Start and stop the real-time log stream
- Filter by level, service, and environment
- Pause to inspect events, then resume
- Click through to event detail
Related docs
Live Tail uses a persistent WebSocket connection via Cloudflare Durable Objects. See the API reference for the WebSocket endpoint and authentication.