Первая буква строки — по ней и разбирают учёт
Короткий код в самом начале строки: d — доставлено, b — отбито, t — временная неудача, и так далее.
Пишется всегда: без него строку не разобрать вовсе. Состав полей задаётся в блоке учёта, и добавлять их стоит осознанно: записей о доставке столько же, сколько доставленных получателей, и каждый лишний столбец умножается на этот объём.
С него начинается любой разбор учёта — все прочие поля осмысленны только в паре с ним.
Главная ловушка — искать вид записи в настройке полей. Поле пишется всегда, первым столбцом, и его нельзя ни выключить, ни переименовать: в файле, где сходятся несколько видов записей, только по нему строки и различаются.
Что делает Хаб. Читает — это одно из четырнадцати полей, которые разбирает нормализатор событий. Значит поле должно быть включено в состав записи, иначе часть телеметрии придёт пустой.
Рекомендуемые значения
Где поле есть:
| Вид записи | Как пишется |
|---|---|
| d — доставка | пишется всегда |
| b — отказ | пишется всегда |
| t — временная неудача | пишется всегда |
| tq — сбой очереди | пишется всегда |
| r — приём | пишется всегда |
| rb, rs — отчёт извне | пишется всегда |
| f — жалоба | пишется всегда |
Поле и правило «пишется всегда, изменить нельзя» — из руководства (§ 12.2.1–12.2.7). Таблица — наша.
Пример в конфигурации
<acct-file /var/log/pmta/acct.csv> records d, b record-fields d rcpt, vmta</acct-file>
Даже в таком коротком наборе первым столбцом строки идёт вид записи — d или b.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Как проверить на узле
Посчитать строки каждого вида в файлах учёта:
cut -d, -f1 /var/log/pmta/acct-*.csv | sort | uniq -c
Строки type — заголовки файлов, остальные — сколько записей каждого вида.
В Хабе
- Цена ошибки
- безопасно: неверное значение ничего не ломает