Stream Telemetry

Once a session has telemetry enabled, you can stream its events in real time. The stream stays open until the session terminates.

Via SDK

Open the stream and iterate over the envelopes:

import Kernel from '@onkernel/sdk';

const kernel = new Kernel();

const stream = await kernel.browsers.telemetry.stream(sessionId);

for await (const { seq, event } of stream) {
  console.log(`#${seq} [${event.category}] ${event.type}`);
}

To filter, check event.category and event.type in your loop. 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:

kernel browsers telemetry stream <session-id>

Filtering by category or event type

# Only network and console events
kernel browsers telemetry stream <session-id> --categories=network,console

# Only specific event types
kernel browsers telemetry stream <session-id> --types=network_response,console_error

# Machine-readable output
# -o json emits newline-delimited JSON envelopes for piping:
kernel browsers telemetry stream <session-id> -o json

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.

kernel browsers telemetry stream <session-id> --seq 1024

The server then replays events after that sequence number.