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
returnModeif 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