Documentation
Overview
Navigate the visual layer on top of TraceLLM.
Overview
The TraceLLM dashboard is a web-based observability interface that surfaces every trace recorded by your LLM stack. It runs at localhost:3000 by default and requires the backend (started via tracellm start) to be running.
Dashboard Layout
The dashboard is organized into five primary views accessible from the sidebar:
| View | Description |
|---|---|
| Overview | Summary of total traces, active projects, recent activity, and system health |
| Traces | Browse, filter, and inspect individual trace records with full step detail |
| Analytics | Aggregated metrics: latency, token usage, error rates, and trends over time |
| Live Logs | Real-time event stream of trace arrivals via WebSocket |
| Failures | Dedicated view for failed traces, retries, and slow requests |
Info
The dashboard connects to the backend API at
http://127.0.0.1:8000 and subscribes to WebSocket events at ws://127.0.0.1:8000/ws. Both addresses are configurable via environment variables.How It Works
- Traces arrive from instrumented code (decorators, CLI, or integrations) and are persisted to MongoDB.
- A WebSocket event (
trace.created) is broadcast to all connected clients. - The dashboard receives the event and updates its trace list in real time without polling.
- Clicking a trace opens the inspector, which fetches the full trace document from
GET /traces/{trace_id}. - The analytics view queries
GET /analyticsto render aggregated charts and breakdowns.
First Steps
To start using the dashboard:
1
Start the stack
Run
tracellm start in your terminal. This launches the FastAPI backend and the WebSocket server.2
Generate traces
Run
tracellm trace "your prompt" or use the @trace decorator in your application code.3
Open the dashboard
Navigate to http://localhost:3000. Traces appear automatically as they are created.
Common Errors
| Error | Cause | Fix |
|---|---|---|
| Dashboard shows offline | Backend not running or port mismatch | Run tracellm start and verify the API is on port 8000 |
| No traces appear | No traces recorded or MongoDB is empty | Run tracellm trace to generate a trace |
| WebSocket disconnected | Backend restarted or network issue | The dashboard auto-reconnects — wait a few seconds |
| Blank page on load | Frontend build issue or missing dependencies | Check the browser console for errors and restart the stack |