laravel:horizon:metrics-and-dashboards について
Laravel Horizon のキューを可観測にし、管理しやすくするスキルです。キューの命名、ワーカー設定、安全な再試行、メトリクス、ダッシュボード、テストを扱います。
主な機能
- 01キューの命名とジョブタグ
- 02ワーカー並行数と再試行設定
- 03失敗処理と冪等性
- 04キューメトリクスとヘルス指標
- 05ディスパッチと統合テストの案内
活用シーン
- 01ドメイン識別子によるジョブ追跡
- 02滞留とキュー性能の監視
- 03失敗ジョブの安全な再試行
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/laravel:horizon:metrics-and-dashboardsを入力して読み込まれたか確認します。
詳細
Horizon：メトリクスとダッシュボード
Horizon を使ってキューを可視化し、アクションにつなげます。
命名とタグ
- 名前付きキュー（例：
high、default、low）を使い、ジョブを意図的に振り分けます - トレースできるよう、ドメイン識別子（ユーザー ID、集約 ID）でジョブにタグを付けます
ワーカーと並行処理
--max-time、--tries、--backoffを適切な値に設定します- 重要なキューは専用のスーパーバイザーに分けます
失敗
- 構造化されたコンテキストを含めて、
failed()メソッドやログ記録を使います - 冪等性を確保し、安全に再試行できるようにします（ユニークキー、アップサート、ガード）
メトリクスとダッシュボード
- スループット、実行時間の分布、再試行、失敗率、処理時間を追跡します
- 滞留数と SLA のしきい値を示すヘルス指標を追加します
- 可能であれば、APM と連携します
テスト
- ディスパッチのアサーションには
Bus::fake()を使います - 副作用とタグを検証する統合テストを実施します
コメント
Markdown 対応