---
title: "Stream telemetry events as Server-Sent Events"
method: GET
path: "/telemetry/stream"
---

# Stream telemetry events as Server-Sent Events

`GET /telemetry/stream`

Opens a live SSE stream of telemetry events. Each frame has the form `id: {seq}\ndata: {envelope-json}\n\n`. Sequence numbers are process-monotonic and persist across configuration changes; a Last-Event-ID from any previous connection is valid for resuming the stream. Drops are signaled by gaps in the `id` field: if the received `id` is more than 1 ahead of the last-seen `id`, events were evicted from the buffer. Clients should track the last-seen `id` to detect gaps. Fresh connections with no Last-Event-ID start from the current sequence and only see new events; pass `?replay=all` to start from the oldest retained event instead. The wire shape is the generic `TelemetryEvent`. For browser events emitted by the Kernel image (or by callers using a documented `type`), the event's `data` conforms to the matching `Browser*EventData` schema, selected by `type`.

## Query parameters

- `replay` 'all'

## Headers

- `Last-Event-ID` string

## Response `200`

Live SSE stream of telemetry events.

## Changes

- **2026-08-13** `c1f3e265b3be` — 1 warning
  - added the new `platform` enum value to the `event/category` response property for the response status `200`
- **2026-06-10** `d36a881dc5fb` — 1 info
  - added the new optional `query` request parameter `replay`
- **2026-06-03** `476130d5c598` — 5 warning, 1 info
  - added the new `captcha` enum value to the `event/category` response property for the response status `200`
  - added the new `connection` enum value to the `event/category` response property for the response status `200`
  - added the new `control` enum value to the `event/category` response property for the response status `200`
  - added the new `monitor` enum value to the `event/category` response property for the response status `200`
  - …2 more
- **2026-05-22** `9a07b5ebd7b8` — 1 warning
  - added the new `api` enum value to the `event/category` response property for the response status `200`
- **2026-05-15** `14ce560a6f1d` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/kernel/apis/kernel-images-api/changes/telemetry/stream/get.md)

---

[API](https://skmtc.dev/kernel/apis/kernel-images-api.md) · [All operations](https://skmtc.dev/kernel/apis/kernel-images-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kernel/kernel-images-api/revisions/7a641fa15a85/schema)