Observability
Monitor tunnels, connections, and engine behavior.
Observability in rstream spans two layers: engine-level telemetry and hosted visibility in the Dashboard.
At the engine level, CE exposes Prometheus metrics and live Engine API state. Hosted rstream and private deployments can add persisted operational history and additional telemetry integrations.
In the hosted platform, the Dashboard can surface tunnel state and connection logs.
Managed WebTTY adds two more observability layers: live session state from the engine and durable session metadata or recordings from hosted storage. The terminal content boundary depends on the WebTTY encryption mode. Metadata can be used for operations and audit without decrypting terminal payloads.
Engine Metrics
Prometheus metrics are optional. When enabled, the engine exposes an HTTP handler that serves metrics points under a configurable path, defaulting to /metrics.
For self-hosted CE, configure the Prometheus listener explicitly and keep it private or protected with a bearer token. See Self-Hosted Operations for runtime checks and scrape examples.
Event Stream
The engine event stream can be consumed over SSE or WebSocket. CE exposes live runtime events and point-in-time inventory. Persisted stream summaries belong to hosted rstream and private operational integrations when they are enabled.
For managed WebTTY, the event stream is the active-state surface:
| Event family | Purpose |
|---|---|
| Registered server online/offline | Show whether the enrolled server currently has an active engine tunnel. |
| Session started/ended | Keep active session lists current without polling. |
| Participant joined/left | Update live collaboration participant lists. |
| Control request created/resolved | Notify controllers, spectators, dashboards, and agent UIs. |
| Recording available/exported | Drive audit and retention workflows. |
Durable records are not live state. A registered server record can exist while the server is offline. A session can be active in the engine before its final recording is committed. The product UI combines Control plane metadata with engine runtime state.
Control plane storage
registered servers, policies, recording metadata, retention
|
| combined with
v
Engine live state
online tunnels, active sessions, participants, control requests
|
v
Dashboard, CLI, rstream ui, webhooks, automation