Admin UI

Admin UI Pages

Detailed guide to every page in the Realtime Platform Admin UI.

The Admin UI contains 17+ pages organized into seven navigation sections. This guide covers every page and its capabilities.

Overview

Dashboard (/)

Three metric panels showing real-time platform health:

  • Realtime Delivery — Active WebSocket connections, reconnect rate, events in/out per second, fanout latency p50/p95/p99
  • Database Pipeline — CDC lag, outbox lag, events captured/routed per second, mapping and schema failures
  • Async Reliability — BullMQ queue depth, retry counts, DLQ size, webhook success/failure rates

Plus a Hot Topics table showing the most active topics with events/sec, subscriber counts, and p95 fanout latency.

Monitoring (/monitoring)

Overall system health and individual service statuses. Shows backend API, workers, Redis, and PostgreSQL connectivity.

Alert Center (/alerts)

System alerts filterable by severity. Environment-aware — shows alerts scoped to the currently selected environment.

Registry

Topics (/topics)

Full CRUD for the topic registry:

  • Create topics with name, description, and owner via a dialog form
  • View all topics in a data table with status indicators
  • Edit topic metadata inline
  • Delete topics with confirmation

Schemas (/schemas)

Schema version browser and registration:

  • Browse schema versions by topic in a searchable list
  • Register new schemas with a JSON editor and compatibility mode selector
  • View schema diffs between versions
  • Validate payloads against the latest schema with an inline validation tool
  • Environment and application-scoped

Mappings (/mappings)

Database-to-topic mapping editor:

  • Create mappings with table, trigger columns, payload field mapping, and conditions
  • Visual rule builder for mapping conditions (no raw JSON required)
  • Version history for each mapping
  • Promote mappings between environments
  • Preview the emitted event payload

Environment Grid (/environments)

Multi-environment overview of all mappings:

  • Grid view showing Development, Staging, and Production columns
  • Color-coded sync status (green = synced, yellow = newer version available, red = missing)
  • Batch promotion across environments
  • Click any cell to see version details

Deployments (/deployments)

Deployment management for promoting configuration across environments:

  • Create deployments with entity picker (topics, mappings, webhooks)
  • Split-panel UI: deployment history (left) and detail panel (right)
  • Generate change reports showing what will be modified
  • Execute and rollback deployments
  • Inline comment system for audit trail

Services

Document Browser (/documents)

Browse and manage sync documents by registered service:

  • Service selector — dropdown populated from registered services (via Services API)
  • Manage Services — gear icon opens inline CRUD dialog for creating, editing, and deleting service namespaces
  • View all documents for the selected service with data, revision, and timestamps
  • Edit document data with a JSON editor
  • Delete documents
  • Auto-loads documents when a service is selected
  • Scoped by current application and environment

Document Inspector (/documents/inspect)

Inspect and modify individual documents:

  • View full document JSON with syntax highlighting
  • Merge partial updates into documents
  • View revision history

Socket Monitor (/socket)

Three-tab WebSocket inspection dashboard:

  • Connections — expandable table of all active connections showing: transport (Socket.IO/WebSocket), remote address, auth subject, channel count, subscription count (with returnMode if set), and uptime. Expand to see user agent, joined channels, and full subscription details.
  • Channels — list all active channels with member counts, inspect members, and broadcast events from the UI
  • Live Traffic — SSE-powered real-time event stream showing connect/disconnect, subscribe/unsubscribe, and broadcast events with pause/resume and clear controls

Webhooks

Endpoints (/webhooks)

Webhook endpoint management:

  • Add new endpoints with URL, secret, and event type selection
  • Activate/deactivate endpoints
  • Delete endpoints
  • View endpoint status and configuration

Delivery Logs (/webhooks/logs)

Webhook delivery history:

  • Filter logs by event type
  • View delivery status, response codes, and retry counts
  • Inspect delivery payloads

Debugging

Event Debugger (/debugger)

Event trace timeline and routing inspection:

  • Timeline view of all events with topic filtering
  • Click any event to see routing details (subscribers matched, filters applied, delivery status)
  • Replay dialog for re-processing events

Replay Tool (/replay)

Replay historical events:

  • Load events from the trace store
  • Select replay mode (dry-run, router, websocket, webhook)
  • Apply overrides to the event payload before replay
  • View replay results

Dashboards

Realtime Delivery (/dashboards/delivery)

Dedicated real-time delivery metrics:

  • Active connections over time
  • Events per second by source
  • Fanout latency percentiles
  • Hot topics breakdown

Database Pipeline (/dashboards/pipeline)

Database event pipeline metrics:

  • CDC lag and outbox lag
  • Events captured vs routed per second
  • Mapping failure rate
  • Schema validation failure rate

Async Reliability (/dashboards/reliability)

Worker and webhook reliability:

  • BullMQ queue depth over time
  • Retry counts and dead-letter queue size
  • Webhook success/failure rates
  • Worker heartbeat status

Security

Signing Keys (/keys)

JWT signing key management:

  • View all keys with status (active/inactive)
  • Create new signing keys
  • Rotate keys (creates new + deactivates old atomically)
  • Deactivate keys

Users (/users)

User account management:

  • CRUD table for user accounts
  • Role assignment dialogs
  • MFA management (setup, disable)
  • Password management

Roles (/roles)

Role and permission management:

  • View built-in roles (super_admin, admin, editor, viewer)
  • Create custom roles
  • Permission matrix editor (resource × action checkbox grid)

Invites (/invites)

User invite management:

  • Create invites with email and role selection
  • Copy invite links
  • Track invite status (pending, accepted, revoked)
  • Revoke and delete invites