デバッグモード

開発中にワーカーの詳細な出力を有効にするには、デバッグモードを有効にします。有効にすると、ジョブの取得、実行、状態遷移のそれぞれについて、追加情報がログに記録されます。

デバッグモードを有効にする

wp-config.phpで定数を定義します:

define( 'QUEUETY_DEBUG', true );

機能

デバッグモードを有効にすると:

• ワーカーは、ジョブの取得試行、空のキュー、リソース確保による延期、スケジューラーの起動、レート制限の確認と取得解除、ジョブクラスのデシリアライズ、ハンドラーの解決について、LogEvent::Debugエントリーをログテーブルに記録します
• 各デバッグエントリーのコンテキストには、ハンドラーの_worker、キュー、messageが含まれます。ジョブの開始、完了、失敗は通常のイベントとしてすでに記録されています

デバッグ状態の確認

use Queuety\Config;

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

使用する場面

• 開発中。 ジョブとワークフローのライフサイクル全体を追跡して、動作を検証します。
• 失敗のトラブルシューティング。 ジョブが失敗した理由やワークフローが停止した理由を詳しく確認します。
• パフォーマンスの調査。 デバッグの記録と通常のcompletedイベントのduration_msを組み合わせ、メトリクス APIを利用します。

本番環境では、ログテーブルが大量のデバッグエントリーで埋まらないよう、デバッグモードを無効にしてください。デバッグエントリーはQueuety::purge_logs()でログを消去するまで残り、自動では削除されません。