Demo
Demo
База знаний PMTA›Блок <domain>›Директива§ 3.3.10.107

enable-tq-record-for-proxy-failure

<domain>

Записывать ли отказы прокси в учёт
в конфигурации это строкаenable-tq-record-for-proxy-failure falseвнутри блока <domain>
Единственный след отказа прокси в учёте

Строка велит записывать сбои соединения с прокси как записи учёта вида tq — временные ошибки уровня очереди. Умолчание — false.

🔴 И она молча ничего не делает, если вид tq не выбран ни в одном блоке учёта. Руководство говорит это прямо. То есть работающих условий два, и оба легко забыть.

Зачем это нужно. Без неё отказ прокси выглядит в учёте как обычная неудача доставки, неотличимая от отказа приёмника. А это совсем разные беды: одна лечится у себя, другая — терпением.

Строка на приёмник. Включать её имеет смысл там, где через прокси идёт заметный трафик, — или в блоке со звёздочкой, если прокси один на всё.

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

🔎 И вид tq в телеметрии не выбран — записи d, b, rb, t, feedback-loop. Значит, сбой прокси до Хаба записью учёта не доходит: включать придётся обе строки — эту и tq в наборе видов. Пока состояние прокси Хаб узнаёт своими проверками, а не из учёта.

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

Работает только при двух выполненных условиях:

Что Где
эта строка в блоке приёмника
вид записей tq в records хотя бы одного блока учёта

Записи tq объёмны — вендор советует держать их в отдельном файле учёта.

Умолчание false и правило «игнорируется без вида tq» — из руководства (§ 3.3.10.107). Довод про неотличимость отказа прокси от отказа приёмника — наш.
Пример в конфигурации
# два условия в разных местах конфигурации
<domain *>
    enable-tq-record-for-proxy-failure yes</domain>

<acct-file /var/log/pmta/transient.csv>
    records tq
</acct-file>
Второй блок обязателен: без вида tq первая строка игнорируется. Отдельный файл — совет вендора: таких записей много.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Включают строку, не выбрав вид записей tq

§ 3.3.10.107

Чем чреватоСтрока игнорируется. Отказы прокси в учёт не попадают, и в панели они по-прежнему неотличимы от отказов приёмника.
Как заметитьСтрока задана, записей вида tq в учёте нет ни одной.
Как правильноДобавить tq в records хотя бы одного блока учёта — лучше отдельного.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
enable-tq-record-for-proxy-failure <boolean>
Значения
yes | no | true | false
Умолчание
false § 3.3.10.107
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<domain>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Директива живёт в <domain> и сливается по обычному правилу блоков получателей: побеждает самое точное совпадение по имени приёмника. Второе условие — набор видов записей — задаётся не здесь, а у файла учёта.
⇄

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

2 связи

Без чего не работает

Временная неудача очередиВид записи, в который отказы прокси и попадают. § 3.3.10.107

Зависит от

smtp-proxy-source-hostGlobalВторой способ настроить прокси; отказы у него записываются так же. § 3.3.10.107

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

records<acct-file>Расширяет, что попадает в записи вида tq, если они вообще выбраны здесь. § 3.3.10.107

Как проверить на узле
Отказы прокси ищут среди записей вида tq — первая колонка их и называет:
cut -d, -f1 /var/log/pmta/transient.csv | sort | uniq -c
Записи tq появятся, только если выполнены оба условия. Пусто при включённой строке — проверьте набор видов у файла учёта.
◇

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

3 статьи

◇Четыре типа значений, на которых написан весь конфигЛогическое, образец домена, регулярное выражение и промежуток времени — определены один раз в § 3.2 и дальше используются всеми директивами.◇Два обработчика входящих отчётов и что с ними делатьОтказы письмом и жалобы разбираются двумя одинаково устроенными блоками; у каждого свой список адресов и своя пара решений о судьбе письма.◇Как складывается политика для приёмникаНастройки собираются от самого общего образца к самому точному; порядок блоков в файле не значит ничего.

В Хабе
Цена ошибки
обратимо: вредит, пока стоит
Сценарии
Классификация отказов · Настроить темп под провайдера
Соседние настройки блока <domain>:disable-acct-recordsdiscard-as-bounceenable-source-ip-limits-on-sending-ipbounce-afterdkim-signВсе 135 директив блока →