
# 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`:

```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

```php
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](https://queuety.inline0.dev/de/docs/features/metrics) 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.
