Queue Manager
Queue Manager: Background Task Processing with Laravel Horizon in rConfig V8
Section titled “Queue Manager: Background Task Processing with Laravel Horizon in rConfig V8”The Queue Manager (Laravel Horizon) is the backbone of rConfig V8’s asynchronous task processing system. It handles all background operations including device configuration downloads, scheduled task execution, backup operations, and system maintenance jobs. Understanding the queue system is essential for maintaining reliable rConfig operations at scale.
What the Queue Manager Does
Section titled “What the Queue Manager Does”The Queue Manager processes asynchronous jobs that would otherwise block the web interface or timeout during execution. When you initiate a backup, schedule a configuration download, or execute any long-running operation, rConfig queues these tasks for background processing rather than making you wait for completion.
This architecture enables:
- Responsive interface: Web interface remains fast regardless of background task load
- Parallel processing: Multiple jobs execute simultaneously across queue workers
- Retry logic: Failed jobs automatically retry with exponential backoff
- Priority handling: Critical operations process before routine tasks
- Visibility: Real-time monitoring of job status and queue health
Core Concepts
Section titled “Core Concepts”Queues: Logical groupings of related jobs (e.g., default, downloads, backups)
Workers: Background processes that pull jobs from queues and execute them
Jobs: Individual tasks like downloading a device configuration or sending an email
Supervisor: System service that ensures queue workers remain running
Horizon Dashboard: Web interface for monitoring queue metrics and job status
Key Queue Operations
Section titled “Key Queue Operations”- Device configuration downloads: All device connection and configuration retrieval operations
- Scheduled tasks: Automated jobs configured in the task scheduler
- System backups: Database and file system backup operations
- Compliance checks: Policy evaluation and compliance report generation
- Email notifications: Asynchronous email delivery
- Log archival: Moving aging logs to archive tables
When to Check the Queue Manager
Section titled “When to Check the Queue Manager”Monitor the Queue Manager when:
- Background tasks appear delayed or not executing
- Scheduled tasks don’t run as expected
- Device configurations aren’t downloading
- System backups fail to complete
- The web interface reports “job queued” but no progress occurs
Quick Access
Section titled “Quick Access”For complete Queue Manager documentation including:
- Installation and configuration procedures
- Supervisor setup for different operating systems
- Queue monitoring and performance tuning
- Troubleshooting common queue issues
- Best practices for production deployments
See the comprehensive guide: Horizon Queue Manager
Related Documentation
Section titled “Related Documentation”- Horizon Queue Manager - Complete queue system documentation
- Scheduled Tasks - Configuring automated jobs that use the queue
- System Logs - Viewing queue worker errors and job failures
- Backups - Backup operations processed through the queue
Summary
Section titled “Summary”The Queue Manager is critical infrastructure for rConfig V8 operations. Every significant background operation—from device configuration downloads to scheduled backups—flows through this system. While the queue system typically operates transparently, understanding its role helps diagnose issues when background tasks don’t execute as expected.
For detailed configuration, monitoring, and troubleshooting information, consult the Horizon Queue Manager documentation in the Automation section.