Skip to main content

​
Overview

The dashboard provides real-time statistics about your API usage, helping you monitor performance and track costs.

​
Stats Cards

​
Total Jobs

The total number of download jobs created with your API key, regardless of status.

​
Completed Jobs

Jobs that successfully:
  1. Downloaded the video
  2. Processed with FFmpeg
  3. Uploaded to S3

​
Failed Jobs

Jobs that encountered an error at any stage. Common reasons:
  • Video unavailable or private
  • Unsupported format
  • Network timeout
  • Rate limiting

​
Processing

Combined count of:
  • Pending: Queued, waiting to start
  • Processing: Currently downloading, muxing, or uploading

​
Storage Used

Total bytes uploaded to your S3 bucket. Displayed in human-readable format (GB, TB).
Storage is cumulative and includes all uploaded files. Deleting files from S3 doesn’t reduce this counter.

​
Daily Chart

The 7-day chart shows job completion trends: 
                Completed ━━━━  Failed ━━━━
    150 ┤
    100 ┤        ╭─╮
     50 ┤   ╭────╯ ╰────╮
      0 ┼───┴───────────┴────────
        Mon Tue Wed Thu Fri Sat Sun

​
Reading the Chart

  • Green line: Completed jobs per day
  • Red line: Failed jobs per day
  • Hover: See exact counts for each day

​
Use Cases

  • Spike in failures: Investigate source URLs or check platform status
  • Consistent completion: System is healthy
  • Declining trend: Usage is decreasing

​
Metrics API

Fetch stats programmatically: 
curl -X GET "https://tornado.velys.software/dashboard/stats" \
  -H "x-api-key: sk_your_api_key"

​
Response

{
  "total_jobs": 1523,
  "pending_jobs": 5,
  "processing_jobs": 12,
  "completed_jobs": 1450,
  "failed_jobs": 56,
  "storage_used_bytes": 53687091200,
  "storage_used_gb": 50.0,
  "client_name": "My App"
}

​
Daily Stats API

Fetch 7-day history: 
curl -X GET "https://tornado.velys.software/dashboard/daily" \
  -H "x-api-key: sk_your_api_key"

​
Response

{
  "daily_stats": [
    { "date": "2024-01-08", "completed": 45, "failed": 2 },
    { "date": "2024-01-09", "completed": 62, "failed": 5 },
    { "date": "2024-01-10", "completed": 58, "failed": 1 },
    { "date": "2024-01-11", "completed": 71, "failed": 3 },
    { "date": "2024-01-12", "completed": 89, "failed": 4 },
    { "date": "2024-01-13", "completed": 102, "failed": 2 },
    { "date": "2024-01-14", "completed": 95, "failed": 3 }
  ]
}

​
Monitoring Best Practices

Monitor the failure rate. If it exceeds 5%, investigate the cause.
Keep an eye on storage usage to avoid unexpected costs.