Horizon и Pulse

Мониторинг фоновых задач, ошибок, нагрузки и медленных операций через Horizon и Pulse

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

В панели управления откройте:

«Утилиты» — «Horizon и Pulse»

Для обоих экранов требуется право «Разрешить доступ к мониторингу данных» из блока «Админпанель».

Horizon

Откройте «Laravel Horizon». Экран показывает состояние обработки фоновых задач: нагрузку очередей, ожидающие, выполненные и ошибочные задания, время ожидания, пропускную способность и работающие обработчики.

Используйте его, когда:

• письмо, уведомление или webhook не отправились;
• импорт или экспорт не завершается;
• обновление курсов, аналитики или медиа зависло;
• диагностика сообщает о проблеме фоновых процессов;
• после исправления нужно проверить повторную обработку.

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

Удаление записи об ошибке очищает доказательство из монитора, но не отменяет выполненное действие и не исправляет причину.

Pulse

Откройте «Laravel Pulse». Экран агрегирует состояние серверов, очередей, исключения, операции с кэшем, медленные запросы, медленные фоновые задания, медленные внешние обращения и активность запросов.

Pulse помогает определить, является ли проблема единичной ошибкой, ростом задержки или общим ухудшением. Начните с временного периода инцидента, затем сопоставьте:

• исключения;
• медленные клиентские запросы;
• медленные обращения к внешним сервисам;
• медленные запросы к данным;
• очередь и фоновые задания;
• загрузку сервера.

Показатели мониторинга зависят от включённых сборщиков и частоты записи. Отсутствие карточки не является доказательством, что событие не происходило.

Передача инцидента

1. Зафиксируйте точное время и пользовательский сценарий.
2. Найдите связанную ошибку или задержку.
3. Сохраните идентификатор заявки или задания без публикации персональных данных.
4. Проверьте связанный журнал панели.
5. Опишите первое подтверждённое отклонение и его повторяемость.
6. После исправления повторите исходный сценарий и проверьте мониторинг.

Не предоставляйте это право обычным операторам: экраны раскрывают внутренние имена операций, параметры ошибок и сведения о нагрузке.

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

Полная работа экрана описана в «Службах обменника», а назначение процессов — в технических инструкциях Laravel Horizon и Laravel Pulse.