Self-Hosted Hintergrunddienste
PerformanceBoard verwendet Laravel Scheduler und Queue-Jobs, damit Shopware-Synchronisationen, Reports und Updates nicht von offenen Browserfenstern abhängig sind.
Empfohlener Plesk-Betrieb
Eine geplante Aufgabe jede Minute genügt:
cd /var/www/vhosts/DEINE-DOMAIN/httpdocs && /opt/plesk/php/8.3/bin/php artisan schedule:runScheduler
Der Scheduler plant die wiederkehrenden Aufgaben. PerformanceBoard schreibt jede Minute einen lokalen Heartbeat. Fehlt dieser länger als wenige Minuten, zeigt System → Hintergrunddienste eine Warnung.
Queue-Tick
Auf On-Premise-Systemen startet der Scheduler jede Minute performanceboard:queue-tick. Dieser startet einen kurzlebigen Laravel Queue Worker für sync,default, verarbeitet vorhandene Jobs und beendet sich spätestens nach ungefähr 45 Sekunden wieder. Das ist besonders für Plesk/shared-hosting-nahe Umgebungen geeignet.
Automatische Shopware-Synchronisation
Alle fünf Minuten prüft performanceboard:sync die aktiven Datenquellen. Es legt für jede fällige Verbindung einen Sync-Job an. Der nächste Queue-Tick verarbeitet ihn. Der erste Abruf ist vollständig; anschließend arbeitet PerformanceBoard inkrementell.
Fehlerbilder
- Scheduler nicht aktiv: Plesk-Task, PHP-CLI-Pfad und Ausführungsintervall prüfen.
- Queue nicht aktiv:
performanceboard:queue-tickmanuell starten und Ausgabe prüfen. - Jobs steigen dauerhaft: Shopware/API-Fehler, PHP-Limits und
failed_jobsprüfen. - Sync bleibt queued: Queue-Tick läuft nicht oder wird durch Hosting-Limits beendet.
- Sync failed: unter Datenquellen/Sync-Historie den konkreten API-Fehler prüfen.
Manuelle Diagnose
/opt/plesk/php/8.3/bin/php artisan performanceboard:scheduler-heartbeat
/opt/plesk/php/8.3/bin/php artisan performanceboard:queue-tick
/opt/plesk/php/8.3/bin/php artisan performanceboard:sync
/opt/plesk/php/8.3/bin/php artisan performanceboard:self-hosted-health