Demo
Demo
База знаний PMTA›Блок <inline-seeding>›Директива§ 11.2.2.2.4

batch-frequency

<inline-seeding>

Как часто узел сверяется со службой засеивания
в конфигурации это строкаbatch-frequency 15sвнутри блока <inline-seeding>
Ритм разговора со службой

Строка задаёт, как часто узел обращается к службе, чтобы согласовать счётчики задания и получить назначения семян. Умолчание — 15s, допустимо от пятнадцати секунд до пяти минут.

Второе условие — объём, persist-threshold: сверка происходит по тому, что наступит раньше.

Увеличивать безопасно при долгих рассылках — так говорит вендор. Смысл тот же: меньше обращений на ту же работу.

Цена увеличения — точность момента. Семена подставляются в рассылку по ходу, и редкая сверка означает, что назначение придёт позже, чем могло бы.

Главная ловушка — поднять и порог, и интервал сразу. Условий всего два, и оба ослаблены: сверка станет редкой по обоим, а на короткой рассылке может не случиться вовсе.
Что делает Хаб. Не пишет: засеиванием вендора мы не пользуемся — оно требует платной подписки на его инструмент и учётной записи с включённой функцией.

🔎 Задача близка к нашей. Контрольные ящики — то, чем мы собирались мерить попадание в папку, — здесь решены вендором: адреса подставляются в рассылку сами, а результат смотрят в его же инструменте. Наш разбор показал, что своими силами это упирается в прокси: опрос ящиков с одного адреса кончается их блокировкой.

Рекомендуемые значения

Значение выбирают по размеру и длительности рассылок:

Значение Когда
15s (умолчание) рассылки короткие
1m–5m задания идут часами
Умолчание 15s, диапазон и совет увеличивать при долгих заданиях — из руководства (§ 11.2.2.2.4).
Пример в конфигурации
<inline-seeding>
    api-key 0123456789abcdef012345678901234567890123
    batch-frequency 5m</inline-seeding>
Вместе с поднятым порогом по объёму это может означать, что короткая рассылка не сверится ни разу.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

Типичные ошибки и проблемы

что делают не так и чем это кончается2 ошибки▶

Ослабляют оба условия сверки сразу

наш опыт

Чем чреватоУсловий два, и оба ослаблены. На короткой рассылке сверка может не случиться ни разу, и семена в неё не попадут.
Как заметитьКороткие рассылки уходят без семян.
Как правильноОслаблять что-то одно и проверять на настоящей рассылке.

Ждут засеивания без подписки на инструмент вендора

§ 11.2

Чем чреватоМеханизм требует учётной записи с включённой функцией и платного доступа к инструменту доставляемости. Без этого ключ не завести, а значит и засеивание не включить.
Как заметитьБлок настроен, семена в рассылках не появляются.
Как правильноПроверить подписку и права ключа в кабинете вендора.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
batch-frequency <value>
Значения
интервал от 15s до 5m
Умолчание
15s § 11.2.2.2.4
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<inline-seeding>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Наследования нет: строка живёт внутри <inline-seeding>, а такой блок на узле только один. Включение засеивания по потокам настраивается не здесь, а строкой enable-inline-seeding с тремя уровнями.
⇄

Связанные директивы

1 связь

Работают в паре

persist-threshold<inline-seeding>Второе условие той же сверки: срабатывает то, что наступит раньше — время или число писем. § 11.2.2.2.2

Сюда ссылаются

eligibility-ttl<inline-seeding>Другой кэш: этот хранит решение о пригодности, тот — расписание сверки. § 11.2.2.2.4

Как проверить на узле
Ритм обращений виден в журнале MTA:
grep -i "seed" /var/log/pmta/log | tail -20
Промежутки должны совпадать с интервалом — либо быть короче, если раньше срабатывает порог по объёму.
◇

Что ещё почитать

2 статьи

◇Засеивание кампаний контрольными адресамиMTA подмешивает в рассылку адреса вендора, а результат смотрят в его инструменте доставляемости; независимо от выгрузки событий.◇Заголовок заданияЗаголовок x-job метит письмо заданием; узел читает его, только если источнику разрешено process-x-job, и тогда задание видно в учёте, мониторе и командах паузы.

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Засеивание и контрольные ящики
Соседние настройки блока <inline-seeding>:eligibility-ttlpersist-thresholdretain-x-sp-subaccount-idprocess-x-sp-subaccount-idapi-keyВсе 6 директив блока →