pmtastats

Сводка по файлам учёта
Отчёт по тому, что уже записано

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

Работает с файлами, а не с живым узлом: отвечает на вопросы о прошлом. Файлов можно назвать несколько — например, если учёт повернули посреди рассылки; сжатые gzip принимаются с расширением .gz или .gzip. Руководство оговаривает, что сейчас программа работает только с учётом в CSV.

Отчёты выбирают словами — vmta-summary, delivery-times, bounce-categories, top-rates и другие, у каждого свои ключи. Общие ключи отбирают записи по заданию, адресу отправки, домену получателя и давности, а –output html даёт отчёт страницей.

Главная ловушка — считать по неполному набору файлов. Учёт поворачивается, и сводка «за неделю» по одному текущему файлу описывает только время с последнего поворота. Нужный период задают набором файлов и ключом –last.
Что делает Хаб. Вызывает — на ней стоит «Статистика учёта»: Хаб запускает pmtastats на самом узле по SSH над файлами учёта с –quiet –output html и разбирает готовые страницы отчётов. Разрезы по одному домену считаются отдельно, с –toDomain.
Рекомендуемые значения

Когда звать:

Вопрос Эта ли команда
как быстро узел доставлял за период да — delivery-times, top-rates
какие категории отказов преобладали да — bounce-categories
что стало с одним письмом нет — acctfind
что происходит сейчас нет — show status
Отчёты, общие ключи, сжатые файлы и оговорка про CSV — из руководства (§ 12.4). Разграничение вопросов наше.
Пример в конфигурации
# сводка по адресам отправки и категориям отказов за сутки
pmtastats --last 1d vmta-summary bounce-categories --bounceCat all acct*pmtastats --output html vmta-time-breakdown acct* > report.html
Обе строки собраны из примеров руководства; acct* — все файлы учёта в каталоге, включая повёрнутые.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Как проверить на узле
Проверить, что программа и файлы учёта на месте:
pmtastats --version
ls -l /var/log/pmta/acct*
Если программа не найдена, проверить путь поиска: её ставит пакет MTA вместе с pmta.
В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Разобраться с доставляемостью