본문으로 건너뛰기

디버그 모드

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

디버그 모드 활성화

다음 위치에서 상수를 정의하세요: 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 API와 함께 확인합니다.

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