# 디버그 모드

개발 중에 자세한 워커 출력을 보려면 디버그 모드를 활성화하세요. 활성화하면 워커가 각 작업의 선점, 실행 및 상태 전환에 관한 추가 정보를 기록합니다.

## 디버그 모드 활성화

다음 위치에서 상수를 정의하세요: `wp-config.php`

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

## 기능

디버그 모드가 활성화되면:

- 워커는 작업 선점 시도, 빈 대기열, 리소스 승인 지연, 스케줄러 틱, 속도 제한 확인 및 선점 취소, 작업 클래스 역직렬화, 핸들러 확인에 대한 `LogEvent::Debug` 항목을 로그 테이블에 기록합니다
- 각 디버그 항목의 컨텍스트에는 핸들러 `_worker`, 대기열 및 `message`가 포함됩니다. 작업 시작, 완료 및 실패는 이미 일반 이벤트로 기록됩니다

## 디버그 상태 확인

```php
use Queuety\Config;

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

## 사용 시점

- **개발 중.** 작업과 워크플로의 전체 수명 주기를 추적해 동작을 확인합니다.
- **실패 문제 해결.** 작업 실패나 워크플로 정체의 원인에 관한 자세한 맥락을 확인합니다.
- **성능 조사.** 디버그 기록을 일반 `completed` 이벤트의 `duration_ms` 및 [metrics](https://queuety.inline0.dev/ko/docs/features/metrics) API와 함께 확인합니다.

로그 테이블이 대량의 디버그 항목으로 가득 차지 않도록 프로덕션 환경에서는 디버그 모드를 비활성화하세요. `Queuety::purge_logs()`로 로그를 정리할 때까지 디버그 항목은 남아 있으며 자동으로 삭제되지 않습니다.