Background Tasks¶
Monitor and manage background jobs and scheduled tasks.
Background Tasks shows all background jobs, their execution status, and scheduling. Monitor long-running operations and troubleshoot job failures.
Navigation: Admin → Tools → Background Tasks
Understanding Background Tasks¶
Background tasks are jobs that run asynchronously:
- Email delivery
- Report generation
- Data synchronization
- Backup execution
- Scheduled maintenance
- ERP integration
Task Queue¶
Shows all tasks with:
- Task Name - What the job does
- Status - Pending/Running/Completed/Failed
- Scheduled - When task is scheduled
- Started - When job started
- Completed - When job finished
- Duration - How long job took
- Result - Success/Failed/Error message
Task Statuses¶
| Status | Meaning |
|---|---|
| Scheduled | Waiting for scheduled time |
| Pending | Queued, waiting to run |
| Running | Currently executing |
| Completed | Finished successfully |
| Failed | Job failed with error |
| Cancelled | Job was cancelled |
Filtering Tasks¶
Filter by:
- Date Range - Today, This Week, All
- Task Type - Email, Report, Sync, etc.
- Status - All, Running, Completed, Failed
- Result - Success, Failed, Warnings
Task Details¶
Click task to view:
- Full Description - What task does
- Scheduled Time - When scheduled
- Start/End Times - Actual execution times
- Duration - Milliseconds elapsed
- Output/Log - Task execution log
- Error Details - Failure reason (if failed)
Retrying Failed Tasks¶
Manual Retry¶
- Find failed task
- Click Retry
- System re-runs task
- Monitor progress
View Retry History¶
See previous attempts and results.
Scheduling Tasks¶
View Schedule¶
Current task schedule shows:
- Email Delivery - Every 5 minutes
- Backups - Daily at 2:00 AM
- Reports - Scheduled times
- Sync Jobs - Configured intervals
Adjust Schedule¶
- Click task
- Edit schedule (if available)
- Save changes
- Schedule updates immediately
Task Performance¶
Monitoring Long-Running Jobs¶
- Review task list
- Check duration of long jobs
- If excessively slow, investigate:
- Database load
- Network connectivity
- Server resources
- Error logs
Optimizing Performance¶
- Distribute tasks across time
- Don't schedule all jobs at same time
- Monitor server resources
- Archive old task logs
Common Background Tasks¶
Email Delivery¶
Sends queued emails periodically:
- Status: Should complete successfully
- Frequency: Every 5-15 minutes
- If failing: Check email settings
Backups¶
Runs scheduled backups:
- Status: Should complete daily
- Frequency: Daily at configured time
- If failing: Check backup settings, disk space
Report Generation¶
Generates requested reports:
- Status: Completes as requested
- Frequency: On-demand or scheduled
- If failing: Check report configuration
ERP Sync¶
Synchronizes data with ERP system:
- Status: Completes per schedule
- Frequency: Configurable interval
- If failing: Check ERP connection settings
Troubleshooting Failed Tasks¶
Task Failed¶
- Click task to view error
- Read error message
- Identify issue:
- Configuration - Settings wrong
- Permission - Access denied
- Resource - Out of memory, disk space
- Network - Connection failed
- Dependency - Required service unavailable
- Fix underlying issue
- Retry task
Task Not Running¶
- Verify task is scheduled
- Check scheduler is enabled
- Review system logs
- Restart if needed