Video Processor

Overview

The Video Processor Dashboard is a real-time monitoring interface for tracking video processing operations in ComusThumbz. It provides comprehensive visibility into queue status, processing performance, error tracking, and hourly trends. The dashboard auto-refreshes every 30 seconds and supports time range filtering for detailed analysis of processing metrics.

Location: Navigate to this page via Admin Panel → Videos → Video Processing Dashboard or access directly via ct/admin/videoprocessordashboard.php

[Screenshot: video-processor-dashboard-main]

Getting to This Page

1. Navigate to Admin Panel → Videos
2. Click Video Processing Dashboard link
3. Alternatively, access directly via ct/admin/videoprocessordashboard.php

System Requirements

PHP Requirements

Required PHP Extensions

Required PHP Functions

Folder Permissions

Network Requirements

Features & UI Elements

Page Header

[Screenshot: video-processor-dashboard-header]

Time Range Filter

[Screenshot: video-processor-dashboard-time-filter]

Navigation Buttons

[Screenshot: video-processor-dashboard-navigation]

Auto-Refresh Toggle

[Screenshot: video-processor-dashboard-auto-refresh]

Queue Overview Cards

[Screenshot: video-processor-dashboard-overview-cards]

Six stat cards displaying real-time metrics:

Job Type Breakdown Table

[Screenshot: video-processor-dashboard-job-types]

Job Types:

• extractmetadata - FFprobe metadata extraction
• transcode - Video transcoding to web format
• generatethumbnails - Timeline thumbnail generation
• generatesprites - Sprite sheet creation
• generatepreview - Preview clip generation
• generategif - Animated GIF creation
• generatecontactsheet - Contact sheet generation
• uploadcdn - CDN upload
• cleanup - Temporary file cleanup

Recent Errors Section

[Screenshot: video-processor-dashboard-errors]

Clear All Errors Button

Hourly Processing Trend Chart

[Screenshot: video-processor-dashboard-chart]

Line chart showing:

• Completed jobs (green line) - Successfully processed
• Failed jobs (red line) - Failed processing

X-axis shows hours, Y-axis shows job count.

Currently Processing Section

[Screenshot: video-processor-dashboard-processing]

Real-time view of active jobs:

Pending Queue Preview

[Screenshot: video-processor-dashboard-pending]

Shows next 10 pending jobs:

Step-by-Step Usage

Monitoring Processing Status

1. Navigate to Admin Panel → Videos → Video Processing Dashboard
2. View overview cards for quick status
3. Check "Currently Processing" for active jobs
4. Review "Pending Queue" for upcoming work

Investigating Processing Errors

1. Scroll to "Recent Errors" section
2. Click video title to view video details
3. Review error message for root cause
4. Click "Acknowledge" after resolving issue

Clearing All Errors

1. Click "Clear All Errors" button
2. Confirm action in dialog
3. All errors marked as acknowledged
4. Fresh errors will appear as they occur

Adjusting Time Range

1. Click time range button (1h, 24h, 7d, 30d)
2. Dashboard reloads with new time range
3. All metrics recalculated for selected period

Managing Auto-Refresh

1. Click auto-refresh toggle to enable/disable
2. Select interval from dropdown (10s, 30s, 60s)
3. Dashboard updates automatically when enabled

AJAX Actions

The dashboard uses POST requests with CSRF protection:

Dashboard Refresh Behavior

Troubleshooting

Common Errors

Cause: videoprocessor.php crashed or was killed during processing
Solution:

1. Check if cron job is running: ps aux | grep videoprocessor
2. Review processor logs: ct/logs/videoprocessor/
3. Jobs will auto-retry up to maxattempts
4. Reset stuck jobs manually if needed:

UPDATE tblVideoProcessingJobs

SET status = 'pending', processingstartedat = NULL, workerid = NULL

WHERE status = 'processing'

AND processingstartedat < DATESUB(NOW(), INTERVAL 1 HOUR);

Cause: System dependency issue (FFmpeg, disk space, CDN)
Solution:

1. Check FFmpeg installation: ffmpeg -version
2. Verify disk space: df -h
3. Test CDN connectivity
4. Review specific error messages

Cause: Cron job not running
Solution:

1. Verify cron job is configured:

crontab -l | grep videoprocessor

1. Test manual execution:

php /path/to/ct/admin/cron/videoprocessor.php

1. Check processor logs for errors

Cause: More jobs being created than processed
Solution:

1. Increase processor frequency (run more often)
2. Reduce concurrent upload volume
3. Add additional processing workers
4. Prioritize important videos with higher priority values

Database Performance

-- Archive completed jobs older than 30 days
INSERT INTO tblVideoProcessingJobsArchive
SELECT * FROM tblVideoProcessingJobs
WHERE status = 'completed'
AND processingcompletedat < DATESUB(NOW(), INTERVAL 30 DAY);

DELETE FROM tblVideoProcessingJobs
WHERE status = 'completed'
AND processingcompletedat < DATESUB(NOW(), INTERVAL 30 DAY);

Color Coding Reference

Status Colors

Priority Levels

Translatable Strings

The following strings should be added to backendtranslations.md:

videoprocessordashboardtitle = "Video Processing Dashboard"
videoprocessordashboardbreadcrumb = "Video Processing Dashboard"
videoprocessordashboardsubtitle = "Real-time monitoring and status of video processing queue"
videoprocessordashboardsettings = "Settings"
videoprocessordashboardqueuevisualizer = "Queue Visualizer"
videoprocessordashboardrefresh = "Refresh"
videoprocessordashboardautorefresh = "Auto Refresh"
videoprocessordashboardautorefreshon = "On"
videoprocessordashboardautorefreshoff = "Off"
videoprocessordashboard1h = "1h"
videoprocessordashboard24h = "24h"
videoprocessordashboard7d = "7d"
videoprocessordashboard30d = "30d"
videoprocessordashboardpendingjobs = "Pending Jobs"
videoprocessordashboardprocessingjobs = "Processing Jobs"
videoprocessordashboardcompletedtoday = "Completed Today"
videoprocessordashboardfailedtoday = "Failed Today"
videoprocessordashboardavgwaittime = "Avg Wait Time"
videoprocessordashboardavgprocessingtime = "Avg Processing Time"
videoprocessordashboardjobtypebreakdown = "Job Type Breakdown"
videoprocessordashboardjobtype = "Job Type"
videoprocessordashboardtotal = "Total"
videoprocessordashboardcompleted = "Completed"
videoprocessordashboardfailed = "Failed"
videoprocessordashboardavgtime = "Avg Time"
videoprocessordashboardsuccessrate = "Success Rate"
videoprocessordashboardrecenterrors = "Recent Processing Errors"
videoprocessordashboardclearall = "Clear All Errors"
videoprocessordashboardjobid = "Job ID"
videoprocessordashboardvideo = "Video"
videoprocessordashboarderror = "Error"
videoprocessordashboardattempts = "Attempts"
videoprocessordashboardtime = "Time"
videoprocessordashboardactions = "Actions"
videoprocessordashboardacknowledge = "Acknowledge"
videoprocessordashboardhourlytrend = "Hourly Processing Trend"
videoprocessordashboardcurrentlyprocessing = "Currently Processing"
videoprocessordashboardstarted = "Started"
videoprocessordashboardduration = "Duration"
videoprocessordashboardworker = "Worker"
videoprocessordashboardpendingqueue = "Pending Queue Preview"
videoprocessordashboardpriority = "Priority"
videoprocessordashboardwaittime = "Wait Time"
videoprocessordashboardnoerrors = "No unacknowledged errors"
videoprocessordashboardnoprocessing = "No jobs currently processing"
videoprocessordashboardnopending = "No pending jobs"
videoprocessordashboardclearconfirm = "Are you sure you want to acknowledge all errors?"

Version History

Related Documentation

• Video Queue Visualizer - Visual queue management
• Video Processor Settings - Processor configuration
• Video Upload System - Upload workflow documentation
• Storage Server System - CDN and storage