persist-threshold

<inline-seeding>

Через сколько писем задания сверяться со службой
в конфигурации это строкаpersist-threshold 5внутри блока <inline-seeding>
Как часто узел спрашивает, кого засеивать

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

Это порог по объёму, а не по времени. По времени работает соседняя строка batch-frequency; сработает то условие, которое наступит раньше.

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

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

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

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

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

Значение Когда
5 (умолчание) рассылки разного размера
100–500 задания обычно крупные, десятки тысяч писем
больше 999 нельзя
Умолчание 5, диапазон и совет поднимать при крупных заданиях — из руководства (§ 11.2.2.2.2).
Пример в конфигурации
<inline-seeding>
    api-key 0123456789abcdef012345678901234567890123
    persist-threshold 500</inline-seeding>
При мелких рассылках такой порог не наберётся, и сверка пойдёт только по времени.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Поднимают порог, не глядя на размер рассылок

наш опыт

Чем чреватоПорог по объёму не наберётся, и всё будет идти по времени — медленнее, а не экономнее.
Как заметитьРассылки небольшие, порог в сотни писем.
Как правильноСоразмерять порог с обычным размером задания.

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

§ 11.2

Чем чреватоМеханизм требует учётной записи с включённой функцией и платного доступа к инструменту доставляемости. Без этого ключ не завести, а значит и засеивание не включить.
Как заметитьБлок настроен, семена в рассылках не появляются.
Как правильноПроверить подписку и права ключа в кабинете вендора.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
persist-threshold <value>
Значения
целое от 5 до 999
Умолчание
5 § 11.2.2.2.2
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<inline-seeding>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Наследования нет: строка живёт внутри <inline-seeding>, а такой блок на узле только один. Включение засеивания по потокам настраивается не здесь, а строкой enable-inline-seeding с тремя уровнями.
Как проверить на узле
Частота обращений видна в журнале MTA:
grep -i "seed" /var/log/pmta/log | tail -20
Промежутки между обращениями должны укладываться либо в этот порог, либо в интервал соседней строки.
В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Засеивание и контрольные ящики