Задания и cron¶

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

Настройка cron¶

Обработчик — bin/plugin mailroom work. Mailroom добавляет его в планировщик Grav как mailroom-worker каждую минуту, поэтому сделать нужно одно: поместить планировщик Grav в crontab пользователя, от которого работает сайт:

PATH=/usr/local/bin:/usr/bin:/bin
* * * * * cd /path/to/site && php bin/grav scheduler >> /dev/null 2>&1

Укажите в строке PATH папку, в которой лежит ваш бинарный файл PHP. На macOS с Homebrew, например, это что-то вроде /opt/homebrew/opt/php@8.4/bin. bin/plugin mailroom status печатает точную строку планировщика для вашего сайта, когда обработчик не запущен, построенную Grav так же, как её строит bin/grav scheduler --install.

Чтобы запускать обработчик иначе (супервизор, собственная строка cron), выключите Run From Grav's Scheduler (worker.scheduler) на вкладке Advanced и запускайте bin/plugin mailroom work каждую минуту сами.

Что делает проход обработчика¶

1. Ставит в очередь периодическую работу, которой пришло время: запуск автоматизаций (движение людей по их автоматизациям) и пересчёт сегментов.
2. Отпускает письма, ждавшие адреса сайта, как только он задан (ниже).
3. Выполняет готовые задания до 50 секунд (--max-time), без ограничения на их число (--max-jobs, 0).
4. Раз в день выполняет уборку.
5. Записывает, когда запускался, что читают status, экран Health и вкладка Sending.

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

Разгрузка после запроса¶

Когда веб-запрос ставит задания в очередь, например письмо подтверждения после подписки, Mailroom выполняет эти задания, и только их, сразу после отправки ответа, в пределах Seconds After a Request (worker.inline_budget_seconds, 3, не более 30). Поэтому подписка подтверждается сразу, даже до настройки cron, и чей-то щелчок не платит за чужой завал.

На PHP-FPM ответ уже у браузера, когда разгрузка начинается. На сервере без FastCGI процесс PHP остаётся занят на время разгрузки, поэтому бюджет мал. Выключите Send Right After the Request (worker.inline_drain), если работа после ответа создаёт проблемы на вашем хостинге; тогда обработчик берёт каждое задание.

Повторные попытки и ошибки¶

Задание, которое упало, пробуется снова с растущим ожиданием (минута после первой ошибки, две после второй, никогда больше часа) до своих попыток. После этого оно остаётся неудачным с последней ошибкой. Задание, работающее дольше Longest One Job May Run (worker.job_timeout_seconds, 120), останавливается и пробуется позже; 0 выключает ограничение.

bin/plugin mailroom status считает неудачные задания, а экраны кампании и импорта говорят, почему их задания упали. Для кампании Retry failed снова отправляет неудачные сообщения (см. Кампании).

Письма, удерживаемые из-за адреса сайта¶

Письму, которое строит обработчик, нужен адрес сайта для ссылок. Если не заданы ни Site URL Mailroom, ни Custom Base URL Grav, такое задание возвращается в очередь на пять минут, не тратя попытку, сколько бы раз это ни требовалось, и одна строка в журнале Grav говорит почему. Как только адрес задан, следующий запуск обработчика отправляет всё, что ждало. См. Устранение неполадок.

Уборка¶

Раз в день обработчик удаляет:

bin/plugin mailroom work печатает, что уборка удалила, в том запуске, когда это происходит.

Работает ли обработчик?¶

• bin/plugin mailroom status показывает Jobs waiting, Jobs failed и Worker last ran. Она перестаёт называть сайт здоровым, когда обработчик не запускался больше 15 минут или не запускался никогда, даже если ничего не ждёт, и печатает строку crontab, которую нужно добавить.
• Проверка The queue worker на экране Health предупреждает, когда обработчик не запускался 15 минут, пока ждут задания.
• Карточка The queue worker на вкладке Sending говорит, когда он запускался последний раз.

Типы заданий¶

Настройки¶

На вкладке Advanced:

Связанные разделы¶

• Установка
• CLI
• Устранение неполадок