Skip to content

Dashboards & sharing

FourEyes has two ways to make results legible at a glance: dashboards and shareable snapshots.

A dashboard is an ordered set of widgets, each a test + metric chart tile in a responsive CSS auto-grid (no layout library). Add, remove, and reorder with a full-replacement UpdateDashboard.

  • Widgets are stored as a single widgets_json column.
  • Widget test IDs are soft references (no foreign key): a deleted test leaves a dangling widget that renders empty, rather than cascading the whole dashboard.

A snapshot is a frozen, read-only incident-window capture that’s shareable without an account.

  • The unguessable 4E-<hex> share token is the sole credential.
  • At create time, the result window is encoded as protojson and stored verbatim — so the link stays frozen and survives deletion of the underlying test (snapshots have no FK to tests).
  • TTL-gated (expires_at_ms, default 90 days, clamped to 1h–365d).
  • The public token lookup returns 404 for both unknown and expired tokens, so a caller cannot enumerate valid links.

Snapshots are great for handing an incident window to an on-call teammate or a vendor without provisioning them an account.