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

disable-acct-records

<domain>критично

Какие виды записей учёта не писать для этой очереди
в конфигурации это строкаdisable-acct-recordsвнутри блока <domain>
Единственный способ заставить учёт молчать

Значение — виды записей через запятую: d доставка, b отказ, t временная неудача, tq неудача постановки в очередь. Отключить можно один вид или все сразу.

Область — очередь, то есть пара «получатель плюс поток отправки», а не узел целиком.

Случай, который называет руководство: письма, отправляемые в никуда — в очередь выбрасывания. MTA по умолчанию пишет им запись доставки, потому что формально доставил, и эта запись искажает статистику. Строка её убирает.

Главная ловушка — учёт это единственный источник правды о доставке. Отключив вид записей, вы не «убрали шум» — вы ослепили себя по этой очереди. Отчёты, показатель доставляемости, разбор жалоб — всё считается по этим записям.

Особенно опасно отключать отказы: их отсутствие выглядит как безупречная доставка, а на деле означает, что о них никто не узнает.

Вторая половина: строка живёт в блоке получателя и подчиняется слиянию. В блоке * она выключит учёт по всему узлу — при том что выглядит настройкой одной очереди.

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

Отключить здесь любой вид записей значило бы потерять соответствующие события в телеметрии безвозвратно.

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

Что ставить. Строка нужна редко и точечно:

Значение Когда
не писать всегда, если исходы разбираются по учёту
d для очереди выбрасывания письма уходят в никуда, и запись о «доставке» портит статистику
несколько видов очередь заведомо служебная и в отчётах не участвует

Отключать отказы (b) не стоит нигде: их отсутствие неотличимо от их отсутствия по-настоящему.

Синтаксис, перечень видов и случай с очередью выбрасывания — из руководства, § 3.3.10.8. Оценка «учёт единственный источник правды» наша.
Пример в конфигурации
# письма уходят в никуда — запись о доставке портит статистику
<domain discard.example>
    disable-acct-records d</domain>
Отключён только один вид. Отказы и временные неудачи по этой очереди продолжают писаться — их отсутствие было бы неотличимо от исправной работы.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Отключают записи, чтобы «убрать шум» из отчётов

наш опыт

Чем чреватоУчёт — единственный источник правды о доставке. Отключённый вид записей исчезает не из отчёта, а из данных: восстановить его потом нечем.
Как заметитьВ отчётах по очереди нет событий, хотя трафик по ней идёт.
Как правильноФильтровать в отчётах, а не отключать запись.

Ставят строку в общем блоке получателей

§ 3.3.10.8

Чем чреватоПо правилу слияния она достаётся всем получателям, которые сами не сказали обратного. Учёт выключается по всему узлу.
Как заметитьЗаписи выбранного вида пропали не по одной очереди, а вообще.
Как правильноСтавить строку в блок конкретной очереди.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
disable-acct-records <type-list>
Значения
виды записей через запятую: d, b, t, tq
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<domain>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Директива живёт в <domain> и подчиняется слиянию блоков получателей: более узкий блок перекрывает более широкий. В блоке * она выключит учёт по всему узлу — при том что выглядит настройкой одной очереди.
⇄

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

2 связи

На что влияет

Доставлено — запись, по которой считают всёЗапись о доставке — та, что пишется даже для писем, отправленных в никуда. § 3.3.10.8

Обычно вместе с

Пять способов очереди отдать письмоВыбрасывание — тот вид доставки, ради которого строку чаще всего и заводят. § 3.3.10.8

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

discard-as-bounce<domain>Другой ответ на ту же задачу: та убирает запись из учёта вовсе, эта меняет её тип. § 3.3.10.8Договор о телеметрииОбратная сторона договора: приёмник можно исключить из учёта на своей стороне, и записей о нём не будет ни в одном блоке. § 3.3.10.8

Как проверить на узле
Строку видно в конфигурации, следствие — по отсутствию записей:
grep -n 'disable-acct-records' /etc/pmta/config /etc/pmta/virtualhost.txt
grep -n -A6 '^<acct-file' /etc/pmta/config
Отсутствие записей по очереди неотличимо от отсутствия трафика по ней. Заметить отключённый вид можно только по этой строке — в самих данных его следа нет.
◇

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

3 статьи

◇Что узел рассказывает о себе и по каким каналамСемь поверхностей наблюдения: веб-монитор, консоль в четырёх форматах, журнал, учёт, поиск по учёту, метрики и выгрузка во внешнюю аналитику.◇Договор о телеметрииОдин блок описывает выход учёта целиком: какие виды записей, какие поля, куда они идут, как сменяются файлы и что обезличивается.◇Как устроена запись учётаКак устроена запись учёта: вид записи в первом столбце, дальше поля, состав которых настраивается.

В Хабе
Цена ошибки
опасно: последствия переживут откат
Сценарии
Разобраться с доставляемостью · Собрать телеметрию
Важность
критично
Соседние настройки блока <domain>:discard-as-bounceenable-tq-record-for-proxy-failureenable-source-ip-limits-on-sending-ipbounce-afterdkim-signВсе 135 директив блока →