Laravel Horizon

Путь, право, назначение, системная служба, метрики и безопасный повтор Laravel Horizon

Laravel Horizon обрабатывает Redis-очереди и показывает ожидание, пропускную способность, длительность и ошибки заданий. Он уже входит в iEXExchanger и запускается автоматически.

Где открыть и какое право нужно

• Путь: «Утилиты» — «Horizon и Pulse» — «Laravel Horizon».
• Право: «Разрешить доступ к мониторингу данных» из блока «Админпанель».
• Где выдать: «Пользователи» — «Список групп пользователей». Откройте нужную группу.

Экран содержит технические имена заданий и ошибки. Не выдавайте это право обычному оператору без необходимости.

Состояние самой службы смотрите по пути «Утилиты» — «Службы». Для просмотра требуется «Просмотр служб обменника», а для действий «Запустить», «Остановить» и «Перезапустить» — «Управление службами обменника» из блока «Админпанель». Операционное право Horizon не заменяет права управления службой.

Что обслуживает Horizon

Один Horizon запускает группы обработчиков, заданные текущей серверной конфигурацией: обычные и приоритетные операции, медиа, аналитику, уведомления, чат, AI, административный поиск и диагностику.

Не запускайте рядом постоянный queue:work, пока не подтверждено, что нужной очереди нет в Horizon. Каждая очередь должна обслуживаться ровно одним механизмом.

Проверка на новом сервере

systemctl --no-pager --full status iex-horizon.service
sudo -u <ПОЛЬЗОВАТЕЛЬ_ПРИЛОЖЕНИЯ> /usr/bin/php8.5 <ПУТЬ_BACKEND>/artisan horizon:status
journalctl -u iex-horizon.service --since '-1 hour' --no-pager

После проверки процесса вызовите одну безопасную задачу и подтвердите её пользовательский результат.

Метрики и Scheduler

Снимки Horizon создаются через Laravel Scheduler. Если задания выполняются, но графики не обновляются, проверьте cron.service, /etc/cron.d/iexexchanger-scheduler и список расписания. Перезапуск Horizon сам по себе не исправит остановленный Scheduler.

Ошибки и повторы

1. Зафиксируйте очередь, время, число попыток и первую ошибку.
2. Проверьте внешний сервис: действие могло завершиться до ошибки ответа.
3. Устраните причину.
4. Повторите одну безопасную задачу.
5. Проверьте отсутствие дубля и конечный результат.

Платёж, callback, выплата и начисление требуют внешней сверки до повтора. Удаление записи об ошибке не отменяет уже выполненную финансовую операцию.

После обновления

Экран «Обновления» сам управляет корректным переключением и службой Horizon. Не выполняйте ручной horizon:terminate параллельно операции. После завершения проверьте экран Horizon, отставание и одну безопасную задачу.

Если требуется отдельное действие после диагностики, используйте строку «Horizon» на экране «Утилиты» — «Службы» и дождитесь записи во вкладке «Журнал действий».

Для существующего сервера под FASTPANEL используется его текущая Supervisor-схема; она описана отдельно. Общие возможности Horizon приведены в официальной документации Laravel.