
# Режим отладки

Включите режим отладки, чтобы во время разработки получать подробный вывод о работе процессов. В этом режиме рабочий процесс записывает дополнительную информацию о каждом захвате задания, его выполнении и переходе состояния.

## Включение режима отладки

Определите константу в `wp-config.php`:

```php
define( 'QUEUETY_DEBUG', true );
```

## Возможности

В режиме отладки:

- Рабочий процесс записывает в таблицу журналов записи `LogEvent::Debug` о попытках захвата заданий, пустых очередях, отложенных заданиях из-за нехватки ресурсов, шагах планировщика, проверках ограничений частоты и снятии заданий с обработки, десериализации классов заданий и поиске обработчиков
- Каждая запись отладки содержит `_worker` обработчика, очередь и `message` в контексте; начало, завершение и сбои заданий уже записываются как обычные события

## Проверка состояния отладки

```php
use Queuety\Config;

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

## Когда использовать

- **Во время разработки.** Отслеживайте полный жизненный цикл заданий и рабочих процессов, чтобы проверить их поведение.
- **Устранение сбоев.** Получайте подробный контекст о причинах сбоя задания или остановки рабочего процесса.
- **Исследование производительности.** Сопоставляйте журнал отладки с `duration_ms` обычных событий `completed` и [метриками](https://queuety.inline0.dev/ru/docs/features/metrics) API.

Отключайте режим отладки в рабочей среде, чтобы не переполнять таблицу журналов большим количеством записей отладки. Они сохраняются, пока вы не очистите журналы с помощью `Queuety::purge_logs()`; автоматическая очистка не выполняется.
