Events

Wire format for telemetry events streamed from the client SDK.

Event message

{
  "type": "client.events",
  "clientSeq": 42,
  "events": [
    {
      "type": "navigation",
      "url": "https://example.com/dashboard",
      "ts": "2025-01-01T00:00:01Z"
    }
  ]
}

clientSeq

The clientSeq field is a monotonically increasing sequence number for deduplication. The session actor tracks the last seen clientSeq and ignores events with a lower or equal sequence number.

Event types

navigation

{ "type": "navigation", "url": "https://example.com/page" }

net.response

{
  "type": "net.response",
  "url": "https://api.example.com/data",
  "status": 200,
  "method": "GET"
}

console

{ "type": "console", "level": "log", "message": "Hello world" }

Storage

Events are persisted with sequence number, timestamp, source, type, and JSON payload.

Next steps

• Events — Higher-level overview
• Yield to User — How events drive condition matching