Отделяет ожидание в очереди от ожидания у приёмника
Отметка времени первой попытки доставки. Включается отдельной директивой узла.
По умолчанию не пишется — поле надо назвать в record-fields. Состав полей задаётся в блоке учёта, и добавлять их стоит осознанно: записей о доставке столько же, сколько доставленных получателей, и каждый лишний столбец умножается на этот объём.
Три отметки вместе — постановка, первая попытка, запись — раскладывают задержку на две части: сколько письмо ждало нас и сколько приёмника.
Главная ловушка — ждать поле от звёздочки. Звёздочка даёт только поля по умолчанию, а это поле в них не входит: пока его не назвать в record-fields, столбца в файле нет вовсе. Вдобавок узел должен отслеживать первую попытку — track-time-first-attempt.
Что делает Хаб. Читает — это одно из четырнадцати полей, которые разбирает нормализатор событий: по нему считается время доставки. В набор по умолчанию поле не входит, поэтому Хаб называет его в record-fields явно — и для вебхука, и для файла учёта, где его же разбирает «Статистика учёта».
Рекомендуемые значения
Где поле есть и входит ли в звёздочку:
| Вид записи | В звёздочке |
|---|---|
| d — доставка | нет |
| b — отказ | нет |
| t — временная неудача | нет |
В общем файле пустое значение бывает двух родов: у строки нет данных — или поле не выбрано для её вида записи.
Виды записей с этим полем и отметки набора по умолчанию — из руководства (§ 12.2.1, § 12.2.2, § 12.2.3); список без звёздочки заменяет набор — § 3.3.11.12. Таблица — наша.
Пример в конфигурации
track-time-first-attempt true <acct-file /var/log/pmta/acct.csv> record-fields d *, timeFirstAttempt</acct-file>
Звёздочка — поля по умолчанию, timeFirstAttempt добавлено к ним; для других видов записей строку повторяют со своей буквой.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
⇄
Связанные записи
0 связей
Как проверить на узле
Проверить, есть ли столбец в последнем файле учёта:
head -1 "$(ls -t /var/log/pmta/acct-*.csv | head -1)" | tr -d '\r' | tr ',' '\n' | grep -n '^timeFirstAttempt$'
Номер строки в выводе — номер столбца в файле; пусто — поле не выбрано ни для одного вида записей этого файла.
В Хабе
- Цена ошибки
- безопасно: неверное значение ничего не ломает