Skip to main content
Telemetry captures events from inside a browser session - console output, network activity, page lifecycle, user interactions, captcha solves, and operational signals like crashes or connection changes. Once enabled, you can stream them live or pull them later for analysis. Events are grouped into categories (console, network, page, and so on), and categories are the unit of control. Selection is opt-in: a session captures only the categories you turn on, and anything you don’t stays off. See Categories for the full list and what each one captures.
Telemetry is a recent addition. If the telemetry options or telemetry stream command aren’t available, upgrade to the latest CLI (kernel upgrade) and SDK (@onkernel/sdk for TypeScript, kernel for Python).

​
Enabling telemetry

You configure telemetry when you create a browser (and can change it later on update). There are three ways to configure it.

​
Enable the default set

Set enabled: true with no per-category settings to capture the default set - a lightweight bundle of operational signals (control, connection, system, captcha) that’s cheap to leave on: 
import Kernel from '@onkernel/sdk';

const kernel = new Kernel();

const browser = await kernel.browsers.create({
  telemetry: { enabled: true },
});

​
Capture specific categories

List the categories you want under telemetry.browser. For example, this session captures console and network only: 
const browser = await kernel.browsers.create({
  telemetry: {
    browser: {
      console: { enabled: true },
      network: { enabled: true },
    },
  },
});

​
Disable telemetry

Telemetry is disabled by default. Use this only when updating a session to turn previously enabled telemetry back off.
Set enabled: false on an existing session to turn telemetry off: 
await kernel.browsers.update(browser.session_id, {
  telemetry: { enabled: false },
});
On update, a category list patches the current selection - categories you don’t include keep their current state. To reset the selection instead, send enabled: true (it replaces the selection with the categories you provide, or the default set if you provide none); send enabled: false to turn telemetry off.

​
What’s next

  • Categories - every category, what it captures, the default set, and cost characteristics.
  • Stream telemetry - consume the live stream from the SDK, CLI, or raw SSE, with filtering and reconnection.
  • For event payload schemas, see the Stream telemetry events endpoint in the API reference.