Структурированный вид
Формат жалобы XARF — JSON вместо классического ARF; MTA принимает его с типом xarf.
Основные поля MTA заполняет сам — отправителя, получателя и адрес доставки. Если они пусты или нужно больше, поле JSON достают в запись учёта путём xarf.<путь>, например xarf.Report.ReportType.
Главная ловушка — не назвать поля в записи. Путь xarf.<путь> работает, только если назван в record-fields записи f: без этого в учёте остаются одни основные поля, и тип жалобы из отчёта теряется.
Что делает Хаб. Отдельно не учитывает: обработчик жалоб на узле есть, но дополнительные столбцы этого формата телеметрия Хаба не разбирает — из записи жалобы берутся только общие поля.
Рекомендуемые значения
Откуда берутся поля:
| Поле | Откуда |
|---|---|
| отправитель, получатель, адрес доставки | заполняются сами |
| тип и подтип жалобы | xarf.Report.ReportType, xarf.Report.ReportSubType |
| кто прислал | xarf.ReporterInfo.ReporterOrgEmail |
Тип xarf, заполняемые поля и путь xarf.<путь> — из руководства (§ 13.7.2). Таблица — наша.
Пример в конфигурации
<acct-file /var/log/pmta/fbl.csv> records feedback-loop record-fields f *,xarf.version,xarf.Report.reportType,xarf.report.smtpRcptToAddress</acct-file>
Сокращённый пример руководства: к стандартному набору добавлены версия, тип жалобы и адрес получателя из JSON.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
⇄
Связанные записи
1 связь
Как проверить на узле
Проверить, что поля XARF попадают в учёт:
head -1 /var/log/pmta/fbl.csv
В заголовке файла должны быть названные поля xarf.….
◇
Что ещё почитать
3 статьи
◇Два обработчика входящих отчётов и что с ними делатьОтказы письмом и жалобы разбираются двумя одинаково устроенными блоками; у каждого свой список адресов и своя пара решений о судьбе письма.◇Обратный адрес, в который вписан получательОтказ приходит на уникальный адрес, и разбирать его содержимое не нужно.◇Что возвращать в отчёте об отказеЧто вкладывать в отчёт об отказе: письмо целиком или только его заголовки.
В Хабе
- Цена ошибки
- безопасно: неверное значение ничего не ломает
- Сценарии
- Классификация отказов