Dashboard & Observability

Real-time telemetry, API explorer, token analysis, and security configuration.

Overview

The Elemm Gateway Dashboard is an optional, standalone observability and management UI. It consists of two parts:

Backend — FastAPI server (dashboard_server.py) for telemetry aggregation and REST+WebSocket API
Frontend — React SPA that connects to the backend and renders the UI

ℹ️ NOTE

The Dashboard is completely optional. The MCP Gateway (elemm-gateway CLI) works independently. The dashboard is not in the request path — it is purely a monitoring and configuration tool.

Starting the Dashboard

Standard Execution (No Build Required)

bash

# Via CLI script
elemm-dashboard

# Or as a Python module
python3 -m elemm_gateway.ui_backend.dashboard_server

Default URL: http://127.0.0.1:8090

Flag	Default	Description
`--host`	`127.0.0.1`	Host address
`--port`	`8090`	Port
`--reload`	`false`	Auto-reload (development)

💡 TIP

The gateway and the dashboard can run simultaneously — they are completely independent processes.

Dashboard Tabs

Observability Console

The central view for real-time monitoring:

Stat Bar (top): Uptime, active clients, active APIs, traffic in/out
Live Activity Panel (left): Chronological log of all tool calls with color coding (green = success, red = error)
Sequence Pipeline (right): Visual representation of execute_sequence calls with per-step timing and payload inspection

Pipeline Chronology

For sequences, the inspector builds a visual chronology:

Each step is shown as a timeline node with index, status, and duration
Performance bars show the relative time share compared to the slowest step

Piping Flow Map

If steps reference parameters from previous results, the data flow is visualized graphically — from source to sink.

Manifest Debugger

A complete API explorer that mirrors the agent's discovery experience:

Landmark Explorer (left): Hierarchical tree of all discovered landmarks
Connection Bar: Connect to any OpenAPI, GraphQL, or Elemm URL
Tool Detail View (center): Parameter definitions, type badges, and return schema
Live Execution Panel (right): Direct tool execution from within the UI

Lazy Loading (On-Demand Auto-Probing)

Deeper directory levels in the manifest are marked as is_truncated by default. When clicking on a closed branch, the frontend automatically fetches the missing tool signatures.

Token Analyzer

Economic simulation and analysis tool:

Live Mode: Connects to an API and compares legacy MCP vs. Elemm token consumption
Simulator Mode: Configurable conversation depth, tool count, piping efficiency, and prompt caching

Security Panel

Visual editor for the Guardian Policy Engine:

Zero-Trust Mode toggle
Whitelist/Blacklist configuration
Pattern editor with regex recognition
DLP and UI masking

Vault Manager

Credential manager for ~/.elemm/vault.json:

Auth type selection (apiKey, bearer, basic)
Automatic UI masking
Deletion protection on active references

Settings

Global gateway configuration:

Resource Limits: Standard and inspection limits
Execution Policy: Timeout, retry attempts, retry delay
UI & Metrics: Display mode, char-to-token ratio
MCP Blending: Global, local sandbox, or selective

WebSocket Real-Time Stream

The frontend connects via WebSocket to ws://127.0.0.1:8090/ws/trace and receives two event types:

status_update: Cyclic system state packets (uptime, sessions, metrics)
activity: Live execution events from tool/sequence actions

The connection is automatically restored every 3 seconds if dropped.