Introduction
Tornado includes a beautiful web dashboard to monitor your jobs, track usage, and view daily statistics. Access it at/dashboard on your API server.
Features
Real-time Stats
View total jobs, completed, failed, and processing counts at a glance
Job History
Browse all your jobs with status, URL, and S3 keys
Batch Tracking
Monitor Spotify show batches with progress bars
Daily Chart
Visualize completed vs failed jobs over the last 7 days
Accessing the Dashboard
Web Interface
Navigate to your API server’s dashboard endpoint:Authentication
The dashboard uses the same API key authentication as the REST API. Enter yoursk_xxxxx key to log in.
Your API key is stored in
localStorage and only sent to the API server. It’s never transmitted to third parties.Dashboard Sections
Stats Cards
The top row shows aggregated statistics:| Card | Description |
|---|---|
| Total Jobs | All jobs ever created |
| Completed | Successfully finished jobs |
| Failed | Jobs that encountered errors |
| Processing | Currently active jobs (pending + processing) |
| Storage | Total storage used in your S3 bucket |
7-Day Chart
A line chart showing job activity over the past week:- Green line: Completed jobs per day
- Red line: Failed jobs per day
Tabs
- All Jobs
- Batches
- Failed
Paginated list of all your jobs with:
- Job ID (truncated)
- Source URL
- Status badge
- S3 output key
Auto-Refresh
The dashboard automatically refreshes every 10 seconds to show the latest data. You can also click the “Refresh” button for immediate updates.API Endpoints
The dashboard uses these API endpoints (all requirex-api-key header):
| Endpoint | Description |
|---|---|
GET /dashboard/stats | Aggregated statistics |
GET /dashboard/jobs | Paginated job list |
GET /dashboard/batches | Batch operations list |
GET /dashboard/daily | Daily stats for chart |