Laravel Pulse

Laravel Pulse — это встроенный экран мониторинга производительности iEXExchanger.

Он помогает смотреть нагрузку на backend-часть проекта, медленные запросы, ошибки, очереди, кеш, фоновые задачи, внешние HTTP-запросы и общее состояние сервера.

Pulse открывается на техническом домене админки:

https://app.ваш_домен/pulse

Для чего нужен Laravel Pulse

Laravel Pulse используется для технического контроля работы системы.

С его помощью можно смотреть:

• состояние сервера;
• активность пользователей и запросов;
• очереди и фоновые задачи;
• работу кеша;
• медленные SQL-запросы;
• ошибки приложения;
• медленные HTTP-запросы;
• медленные задачи в очередях;
• медленные внешние запросы к API, мерчантам, выплатам и другим сервисам.

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

Где находится Laravel Pulse

В панели управления откройте: «Утилиты» — «Horizon и Pulse» — «Laravel Pulse»

Прямой адрес:

https://app.ваш_домен/pulse

Если пункт меню не отображается, проверьте права группы пользователя.

Права доступа

Доступ к Laravel Pulse разрешается только пользователям панели управления, у которых есть право:

Разрешить доступ к мониторингу данных

Это право находится в настройках групп пользователей.

Рекомендуется выдавать доступ к Pulse только:

• владельцу проекта;
• техническому администратору;
• ответственному специалисту.

Обычным менеджерам этот раздел обычно не нужен, потому что в Pulse отображается техническая информация о работе системы.

---

Включение Laravel Pulse

По умолчанию Laravel Pulse может быть выключен.

Чтобы включить его, нужно изменить настройки backend-проекта на сервере.

Перейдите в директорию backend-проекта:

Файлы сайта в FastPanel

cd /var/www/имя_пользователя_backend/data/www/app.ваш_домен

Откройте файл .env и добавьте или измените параметр:

PULSE_ENABLED=true

Если такой строки нет, добавьте её в конец файла.

После изменения .env очистите кеш конфигурации:

php artisan optimize:clear

Если на сервере используется PHP 8.4 через FastPanel, команда может выглядеть так:

Подключение к серверу по SSH

/opt/php84/bin/php artisan optimize:clear

---

Проверка таблиц Pulse

В iEXExchanger таблицы Pulse уже предусмотрены в структуре системы.

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

php artisan migrate --force

Для PHP 8.4:

Подключение к серверу по SSH

/opt/php84/bin/php artisan migrate --force

Pulse использует таблицы:

pulse_entries
pulse_aggregates
pulse_values

Если этих таблиц нет, экран Pulse не сможет корректно собирать и показывать данные.

---

Настройка хранения данных

По умолчанию Pulse хранит данные в базе данных.

Для большинства проектов достаточно такой настройки:

PULSE_ENABLED=true
PULSE_STORAGE_DRIVER=database
PULSE_INGEST_DRIVER=storage
PULSE_STORAGE_KEEP="7 days"
PULSE_INGEST_KEEP="7 days"

Что означает:

Параметр	Что делает
PULSE_ENABLED=true	Включает сбор данных Pulse
PULSE_STORAGE_DRIVER=database	Хранит данные в базе данных
PULSE_INGEST_DRIVER=storage	Записывает данные напрямую в хранилище
PULSE_STORAGE_KEEP="7 days"	Хранит собранную статистику 7 дней
PULSE_INGEST_KEEP="7 days"	Хранит входящие данные 7 дней

Рекомендуемые настройки для обычного проекта

Добавьте в .env:

PULSE_ENABLED=true
PULSE_STORAGE_DRIVER=database
PULSE_INGEST_DRIVER=storage
PULSE_STORAGE_KEEP="7 days"
PULSE_INGEST_KEEP="7 days"
PULSE_SERVER_NAME=main

После этого выполните:

php artisan optimize:clear

Затем откройте:

https://app.ваш_домен/pulse

---

Если используется Redis ingest

Обычно Redis ingest не требуется для небольших и средних проектов.

Но если проект высоконагруженный и нужно разгрузить обычные web-запросы, можно использовать Redis ingest:

PULSE_INGEST_DRIVER=redis
PULSE_REDIS_CONNECTION=default

В этом режиме необходимо запустить отдельный процесс Pulse:

php artisan pulse:work

Для production такой процесс нужно запускать через Supervisor, чтобы он автоматически перезапускался при сбоях.

Пример команды для Supervisor:

php /var/www/имя_пользователя_backend/data/www/app.ваш_домен/artisan pulse:work

Если Redis ingest не используется, pulse:work запускать не нужно.

---

Снимок состояния сервера

В Pulse есть команда:

php artisan pulse:check

Она делает снимок текущего состояния сервера для блока server monitoring.

Команду можно запускать вручную:

php artisan pulse:check

Если нужно регулярное обновление серверных показателей, проверьте, что на сервере работает Laravel Scheduler через CRON.

Планировщик задач

---

Что отображается в Pulse

В вашей системе экран Pulse содержит несколько блоков:

• Сервер;
• Использование системы;
• Очереди;
• Кеш;
• Медленные SQL-запросы;
• Ошибки;
• Медленные запросы;
• Медленные задачи;
• Медленные внешние запросы.

1

Сервер

Блок «Сервер» показывает состояние сервера и базовые показатели нагрузки.

Он помогает понять, насколько сервер справляется с текущей активностью.

2

Использование системы

Блок «Использование системы» показывает активность приложения: запросы, пользователей и общую работу backend-части.

Этот блок полезен для оценки текущей нагрузки на систему.

3

Очереди

Блок «Очереди» показывает работу очередей и фоновых задач.

Он полезен, если в системе используются:

• уведомления;
• Telegram-уведомления;
• e-mail-уведомления;
• парсеры;
• выплаты;
• фоновые проверки;
• отложенные задачи.

Если очередь растёт и не уменьшается, нужно дополнительно проверить Laravel Horizon, Redis и Supervisor.

4

Кеш

Блок «Кеш» показывает обращения к кешу.

Он помогает понять:

• используется ли кеш;
• много ли промахов кеша;
• нет ли лишней нагрузки на базу данных;
• эффективно ли система повторно использует сохранённые данные.

5

Медленные SQL-запросы

Блок «Медленные SQL-запросы» показывает запросы к базе данных, которые выполнялись дольше установленного порога.

По умолчанию порог может быть около:

1000 мс

Этот блок помогает находить места, которые замедляют админку, API или сайт.

6

Ошибки

Блок «Ошибки» показывает ошибки приложения.

Если на сайте или в админке что-то работает нестабильно, этот блок помогает быстрее найти причину.

Ошибки нужно анализировать вместе с логами приложения и действиями, после которых они появились.

7

Медленные запросы

Блок «Медленные запросы» показывает страницы и backend-запросы, которые выполнялись слишком долго.

Он полезен для диагностики медленной загрузки:

• сайта;
• админки;
• API;
• карточек заявок;
• страниц с большими таблицами.

8

Медленные задачи

Блок «Медленные задачи» показывает фоновые задачи, которые выполняются дольше ожидаемого.

Например:

• уведомления;
• обработка заявок;
• парсеры;
• интеграции;
• экспорт;
• аналитика.

Если задача часто попадает в медленные, проверьте её очередь в Horizon и причину долгого выполнения.

9

Медленные внешние запросы

Блок «Медленные внешние запросы» показывает медленные обращения к внешним сервисам.

Это полезно при работе с:

• мерчантами;
• автовыплатами;
• API курсов;
• внешними парсерами;
• Telegram;
• почтовыми сервисами;
• другими интеграциями.

Если внешний сервис отвечает медленно, проблема может быть не в сервере iEXExchanger, а во внешней стороне.

---

Настройка порогов медленных операций

Если нужно изменить чувствительность Pulse, можно добавить в .env:

PULSE_SLOW_QUERIES_THRESHOLD=1000
PULSE_SLOW_REQUESTS_THRESHOLD=1000
PULSE_SLOW_JOBS_THRESHOLD=1000
PULSE_SLOW_OUTGOING_REQUESTS_THRESHOLD=1000

Значения указываются в миллисекундах.

Примеры:

1000 = 1 секунда
2000 = 2 секунды
5000 = 5 секунд

Если поставить слишком маленькое значение, Pulse будет показывать слишком много событий.

Для production обычно достаточно:

1000–2000 мс

После изменения параметров выполните:

php artisan optimize:clear

---

Как отключить Laravel Pulse

Если Pulse больше не нужен, его можно отключить.

Файлы сайта в FastPanel

В .env укажите:

PULSE_ENABLED=false

Затем выполните:

php artisan optimize:clear

После этого Pulse перестанет собирать новые данные.

Как очистить данные Pulse

Если нужно удалить старую статистику Pulse, выполните:

Подключение к серверу по SSH

php artisan pulse:clear

Команда очищает накопленные данные Pulse из хранилища.

Используйте очистку осторожно. После выполнения команды старая статистика в Pulse пропадёт.

---

Частые проблемы

Страница Pulse не открывается

Проверьте:

• включён ли параметр PULSE_ENABLED=true;
• выполнена ли команда php artisan optimize:clear;
• открываете ли вы backend-домен app.ваш_домен, а не основной frontend-домен;
• есть ли у пользователя право «Разрешить доступ к мониторингу данных»;
• выполнены ли миграции таблиц Pulse.

В меню нет Laravel Pulse

Проверьте группу пользователя.

У пользователя должно быть право:

Разрешить доступ к мониторингу данных

После выдачи права выйдите из панели управления и войдите снова.

Pulse открывается, но данных мало

Такое возможно сразу после включения.

Pulse начинает собирать данные только после активации. Откройте сайт, админку, выполните несколько тестовых действий или подождите несколько минут.

После этого данные начнут появляться.

Не отображаются серверные показатели

Проверьте запуск команды:

php artisan pulse:check

Также проверьте, что на сервере настроен CRON для Laravel Scheduler.

Pulse показывает много медленных запросов

Проверьте пороги в .env.

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

Для production обычно достаточно:

1000–2000 мс

После изменения .env Pulse не изменился

Очистите кеш конфигурации:

php artisan optimize:clear

Если используется Redis ingest и отдельный процесс pulse:work, перезапустите процесс через Supervisor.

Рекомендации

Для обычного production-проекта достаточно включить:

PULSE_ENABLED=true
PULSE_STORAGE_DRIVER=database
PULSE_INGEST_DRIVER=storage
PULSE_STORAGE_KEEP="7 days"
PULSE_INGEST_KEEP="7 days"
PULSE_SERVER_NAME=main

Не выдавайте доступ к Pulse всем менеджерам. Этот раздел предназначен для технического контроля системы.

Если проект высоконагруженный, можно отдельно настроить Redis ingest и запуск pulse:work через Supervisor. Для большинства обменников это не требуется на старте.

---

Коротко

Laravel Pulse — это экран мониторинга производительности iEXExchanger.

Он помогает видеть медленные запросы, ошибки, очереди, кеш, внешние API-запросы и состояние сервера.

Чтобы включить Pulse, добавьте в .env:

PULSE_ENABLED=true

Затем выполните:

php artisan optimize:clear

Pulse открывается здесь:

https://app.ваш_домен/pulse

В панели управления: «Утилиты» — «Horizon и Pulse» — «Laravel Pulse»

Доступ должен быть только у пользователей с правом:

Разрешить доступ к мониторингу данных