Skip to content

Live Tail

The Live Tail tab streams every flag evaluation as it happens, giving you a real-time view of how your flags are being used across all environments.

Accessing Live Tail

Navigate to Observability → Live Tail in the admin sidebar. The connection opens automatically and begins streaming evaluation events.

Event table

Each evaluation appears as a row with the following columns:

ColumnDescription
TimeWhen the evaluation occurred (local timezone)
FlagKey of the evaluated flag
ReasonWhy the flag resolved to its value (targeting, rollout, default, disabled, override, environment_override)
DurationEvaluation time in milliseconds
ValueThe resolved flag value
ActorTruncated token prefix of the caller
ContextCompact summary of the evaluation context

Toolbar

The toolbar above the event table provides filtering and playback controls:

  • Flag search — type a flag key to filter events to that flag
  • Reason filter — select one or more evaluation reasons to narrow the stream
  • Stats — displays total events and the current events-per-second rate (updated every 5 seconds)
  • Pause / Resume — temporarily halt the stream without disconnecting
  • Clear — remove all events from the table

Keyboard shortcuts

KeyAction
pPause or resume the stream
cClear all events

Status bar

The bottom status bar shows:

  • Connection indicator — green when connected, yellow while reconnecting, red when disconnected
  • Auto-scroll toggle — when enabled, the table scrolls to show the latest event
  • Jump to latest — scrolls to the most recent event (visible when auto-scroll is off)

Backfill

When you first connect, the server sends the last 50 evaluation events from its ring buffer so you have immediate context. These backfilled events appear in the table just like live events.