Logging

View as Markdown Edit on GitHub Docs at 2cc7b2b

Queuety logs every job and workflow event to the queuety_logs database table. There are no log files. All entries are queryable via the PHP API and CLI.

Event types

Every log entry has an event type from the LogEvent enum:

Event	Description
`started`	Job execution started
`completed`	Job completed successfully
`failed`	An attempt threw and will be retried (the final attempt logs only `buried`)
`buried`	Job exhausted all retry attempts
`retried`	Job was scheduled for retry
`workflow_started`	Workflow was dispatched
`workflow_completed`	All workflow steps finished
`workflow_failed`	Workflow step failed permanently
`workflow_paused`	Workflow was paused
`workflow_resumed`	Workflow was resumed
`workflow_cancelled`	Workflow was cancelled
`workflow_rewound`	Workflow was rewound to an earlier step
`workflow_forked`	Workflow was forked into a new workflow
`workflow_deadline_exceeded`	Workflow missed its `must_complete_within()` deadline
`debug`	Debug-level message (when `QUEUETY_DEBUG` is enabled)

Log fields

Each log entry contains:

Field	Description
`id`	Auto-increment ID
`event`	Event type string
`handler`	Handler name or class
`job_id`	Associated job ID (nullable)
`workflow_id`	Associated workflow ID (nullable)
`step_index`	Workflow step index (nullable)
`attempt`	Attempt number
`duration_ms`	Execution duration in milliseconds
`error_message`	Error message if failed
`created_at`	Timestamp

Querying logs via PHP

PHP

$logger = Queuety::logger();

// Logs for a specific job
$logs = $logger->for_job( 42 );

// Logs for a specific workflow
$logs = $logger->for_workflow( 7 );

// Logs for a specific handler
$logs = $logger->for_handler( 'send_email', 50 );

// Logs for a specific event type
$logs = $logger->for_event( \Queuety\Enums\LogEvent::Failed, 50 );

// Logs since a datetime
$logs = $logger->since( new \DateTimeImmutable( '-1 hour' ), 100 );

Querying logs via CLI

Shell

# Recent logs (last 24 hours)
wp queuety log

# Logs for a specific job
wp queuety log --job=42

# Logs for a specific workflow
wp queuety log --workflow=7

# Logs for a handler
wp queuety log --handler=send_email

# Logs for an event type
wp queuety log --event=failed

# Logs since a datetime
wp queuety log --since="2025-01-01 00:00:00"

# Custom limit and format
wp queuety log --limit=100 --format=json

Log retention

Logs are kept until you purge them. The QUEUETY_LOG_RETENTION_DAYS constant is read by Config::log_retention_days() but nothing uses it yet, so it does not purge anything (#15). The wp queuety log purge subcommand cannot be reached either (#11).

Purge from PHP, for example from your own scheduled task or with wp eval:

PHP

$count = Queuety::logger()->purge( 30 );