# Modo de depuração

Ative o modo de depuração para obter uma saída detalhada do worker durante o desenvolvimento. Quando ativado, o worker registra informações adicionais sobre cada solicitação, execução e transição de estado de job.

## Ativar o modo de depuração

Defina a constante em `wp-config.php`:

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

## O que ele faz

Com o modo de depuração ativado:

- O worker grava entradas `LogEvent::Debug` na tabela de logs para tentativas de solicitação, filas vazias, adiamentos por admissão de recursos, ciclos do agendador, verificações de limite de taxa e liberações de jobs, desserialização da classe do job e resolução do handler
- Cada entrada de depuração inclui o `_worker` do handler, a fila e um `message` no contexto; o início, a conclusão e a falha do job já são registrados como eventos normais

## Verificar o status da depuração

```php
use Queuety\Config;

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

## Quando usar

- **Durante o desenvolvimento.** Acompanhe todo o ciclo de vida de jobs e workflows para verificar o comportamento.
- **Solução de falhas.** Obtenha contexto detalhado sobre os motivos de uma falha em um job ou de uma interrupção em um workflow.
- **Investigação de desempenho.** Combine o histórico de depuração com `duration_ms` dos eventos `completed` normais e com [métricas](https://queuety.inline0.dev/pt/docs/features/metrics) de API.

Desative o modo de depuração em produção para evitar que entradas de depuração em grande volume encham a tabela de logs. As entradas de depuração permanecem até que você apague os logs com `Queuety::purge_logs()`; nada as apaga automaticamente.