Debug-Modus

Aktiviere den Debug-Modus, um während der Entwicklung ausführliche Worker-Ausgaben zu erhalten. Ist er aktiviert, protokolliert der Worker zusätzliche Informationen zu jedem Job-Abruf, jeder Ausführung und jedem Statuswechsel.

Debug-Modus aktivieren

Definiere die Konstante in wp-config.php:

define( 'QUEUETY_DEBUG', true );

Funktionen

Bei aktiviertem Debug-Modus:

• Der Worker schreibt LogEvent::Debug-Einträge in die Protokolltabelle für Abrufversuche, leere Warteschlangen, Verzögerungen durch Ressourcenbeschränkungen, Scheduler-Ticks, Ratenbegrenzungsprüfungen und Freigaben, das Deserialisieren von Job-Klassen sowie die Handler-Auflösung
• Jeder Debug-Eintrag enthält den Handler _worker, die Warteschlange und einen message in seinem Kontext; Jobstart, Abschluss und Fehlschlag werden bereits als reguläre Ereignisse protokolliert

Debug-Status prüfen

use Queuety\Config;

if ( Config::debug() ) {
    // Debug mode is active
}

Wann du ihn verwenden solltest

• Während der Entwicklung. Verfolge den gesamten Lebenszyklus von Jobs und Workflows, um ihr Verhalten zu überprüfen.
• Fehler beheben. Ermittle anhand detaillierter Kontextinformationen, warum ein Job fehlgeschlagen ist oder ein Workflow ins Stocken geraten ist.
• Leistung untersuchen. Kombiniere den Debug-Verlauf mit duration_ms der regulären Ereignisse vom Typ completed und den Metriken API.

Deaktiviere den Debug-Modus in der Produktionsumgebung, damit die Tabelle nicht mit einer großen Menge an Debug-Einträgen gefüllt wird. Debug-Einträge bleiben erhalten, bis du die Protokolle mit Queuety::purge_logs() bereinigst; sie werden nicht automatisch gelöscht.