The Laddr dashboard provides a web-based interface for monitoring agents, viewing traces, and interacting with your multi-agent system.
Starting the Dashboard
Start the full Laddr stack:
laddr run dev -d
# or
docker compose up -d
The dashboard automatically connects to the API server at http://localhost:8000.
Dashboard Features
Agent Overview
View all registered agents and their status:
- Agent List - All agents in your system
- Status Indicators - Running, idle, or error states
- Worker Count - Number of active workers per agent
Real-Time Traces
Monitor agent execution in real-time:
- Execution Timeline - See each step as it happens
- Tool Calls - View tool invocations and results
- LLM Interactions - See prompts and responses
- Token Usage - Track LLM costs
Job History
Browse past executions:
- Job List - All completed jobs
- Search & Filter - Find specific jobs
- Job Details - View full execution trace
- Replay Jobs - Re-run previous jobs
System Metrics
Monitor system health:
- Queue Status - Message queue health
- Database Status - Connection status
- Storage Status - Storage backend health
- Worker Metrics - Active workers and throughput
Using the Playground
Submit a Job
- Navigate to the Playground tab
- Select an agent from the dropdown
- Enter input JSON:
{
"query": "What is Laddr?",
"max_results": 5
}
- Click Submit
- Watch the execution in real-time
View Traces
- Click on any job in the Jobs tab
- View the execution trace:
- Timeline - Chronological view
- Tree View - Hierarchical structure
- Raw JSON - Complete trace data
Replay Jobs
- Find a job in the Jobs tab
- Click Replay
- Choose:
- Return stored result - Get cached result
- Re-execute - Run the job again
API Integration
The dashboard uses the REST API. You can also use the API directly:
Submit via API
curl -X POST http://localhost:8000/api/prompts \\
-H "Content-Type: application/json" \\
-d '{
"prompt_name": "researcher",
"inputs": {"query": "What is Laddr?"}
}'
Get Job Status
curl http://localhost:8000/api/prompts/{prompt_id}
List Jobs
curl "http://localhost:8000/api/prompts?limit=50"
Monitoring Best Practices
Watch for Errors
Monitor the dashboard for:
- Failed Jobs - Check error messages
- Timeout Errors - Increase timeout or optimize agent
- Tool Errors - Verify tool configuration
- LLM Errors - Check API keys and quotas
Use metrics to identify:
- Slow Agents - High execution times
- High Token Usage - Optimize prompts
- Queue Backlog - Scale workers
- Storage Usage - Monitor artifact storage
Debug Issues
Use traces to debug:
- View Full Trace - See every step
- Check Tool Results - Verify tool outputs
- Review LLM Calls - Inspect prompts/responses
- Compare Jobs - Find patterns in failures
Keyboard Shortcuts
/ - Focus search? - Show shortcutsEsc - Close modalsCtrl+K - Quick actions
Troubleshooting
Dashboard Not Loading
# Check if services are running
laddr ps
# Check dashboard logs
docker compose logs dashboard
# Restart services
docker compose restart dashboard
API Connection Errors
Verify API server is running:
curl http://localhost:8000/api/health
No Jobs Showing
Ensure workers are running:
laddr ps
# Start workers if needed
docker compose up -d researcher_worker coordinator_worker
Next Steps
