Skip to main content
Once a session has telemetry enabled, you can stream its events in real time. The stream stays open until the session terminates and counts as activity, even when no new events arrive.

Via SDK

Open the stream and iterate over the envelopes:
To filter, check event.category and event.type in your loop, or pass type when you open the stream. For direct HTTP requests, repeat type or pass comma-separated values for multiple types. The Read telemetry events endpoint accepts the same filter. If the stream drops, re-open it with the last seq you processed as last_event_id to resume without gaps.

Via CLI

Stream events to your terminal. The command runs until the session ends or you interrupt it:

Filtering by category or event type

Resuming after a disconnect

The stream is a single connection; it does not reconnect on its own. Each event carries a monotonic seq, so to resume without gaps you re-open the stream and pass the last seq you processed.
The server then replays events after that sequence number.