Собрать телеметрию
записей в сценарии: 70
disable-acct-records<domain>критичноДирективаОтключает создание записей учёта выбранных видов — доставки, отказа, временной неудачи, неудачи постановки — для отдельной очереди.http-accessGlobalкритичноХаб задаёт самДирективаСписок адресов и уровней доступа к управляющему интерфейсу; по умолчанию закрыт всем.http-api-keyGlobalкритичноХаб задаёт самДирективаКлюч в заголовке X-API-Key даёт права администратора с любого адреса; строка повторяется.record-fields<acct-file>критичноХаб задаёт самДирективаСписок полей для одного вида записей; умолчание — звёздочка, то есть набор полей по умолчанию, помеченный в таблицах руководства; поддерживает исключение и произвольные заголовки письма.records<acct-file>критичноХаб задаёт самДирективаСписок из восьми возможных видов записей учёта; умолчание — доставки и локальные отказы.discard-as-bounce<domain>ДирективаОчередь вида discard всё равно пишет в учёт — эта строка решает, какой буквой.enable-signalsGlobalДирективаОхват выгрузки с тремя уровнями наследования; сюда же дописываются субсчёт, область отслеживания или имя списка правил.http-mgmt-portGlobalХаб задаёт самДирективаTCP-порт управляющего интерфейса; значение 0 не поднимает монитор вовсе. Умолчание 8080.http-webhook-url<acct-file>Хаб задаёт самДирективаЭндпоинт, принимающий записи учёта по HTTP; путь в теге блока при этом остаётся и служит промежуточным хранилищем.iso-times<acct-file>ДирективаЗаписывать ли отметки времени в формате ISO; по умолчанию да.privacy-policy<acct-file>ДирективаЗаменяет левую часть адреса заглушкой или хешем; умолчание — оставлять как есть.sync<acct-file>ДирективаЗаставляет операционную систему регулярно сбрасывать буферы файла учёта; по умолчанию выключено.track-time-first-attemptGlobalХаб задаёт самДирективаВключает подсчёт времени первой попытки; открывает поле в записях учёта и метрику задержки. По умолчанию выключено.delete-after<acct-file>Хаб задаёт самДирективаСрок хранения файла учёта до удаления; умолчание восемь дней, действует только без перемещения.http-webhook-extra-headers<acct-file>Хаб задаёт самДирективаПуть к файлу, каждая строка которого — заголовок HTTP, добавляемый к запросу с пачкой записей.http-webhook-max-connections<acct-file>ДирективаЧисло потоков отправки записей учёта на эндпоинт; умолчание один, потолок пятьдесят.http-webhook-max-interval<acct-file>Хаб задаёт самДирективаИнтервал сбора записей в пачку перед отправкой; минимум одна минута, умолчание пять.map-header-to-field<acct-file>ДирективаКладёт содержимое заголовка письма в готовое поле записи выбранного вида; по умолчанию не настроена.max-size<acct-file>Хаб задаёт самДирективаПотолок, по достижении которого начинается новый файл; для вебхука — предельный размер пачки.min-free-space<signals>ДирективаНиже этого порога узел начинает удалять неотправленные файлы выгрузки; умолчание 20 МБ.move-to<acct-file>ДирективаКаталог назначения для перемещения файлов учёта; по умолчанию перемещения нет.queue-filter<acct-file>ДирективаСписок имён очередей с необязательным отрицанием; по умолчанию пишутся записи всех очередей.time-first-attempt-domains-file<prometheus-listener>ДирективаСписок приёмников, до ста имён, для которых метрика первой попытки получает свою метку; остальные попадают в other.track-inbound-perf-statsGlobalДирективаВключает подсчёт времени от MAIL FROM до конца DATA на приёме; полезна только вместе со слушателем метрик.type<domain>ДирективаОдна строка, переключающая очередь между пятью способами доставки.user-string<acct-file>ДирективаПроизвольный текст, попадающий в поле userstring; работает только если это поле перечислено в наборе полей.world-readable<acct-file>ДирективаДаёт всем пользователям узла право читать новые файлы учёта; по умолчанию нет.count-moved-records<acct-file>ДирективаДописывает число записей к сообщению журнала о перемещении файла CSV; по умолчанию выключено.http-webhook-ca-file<acct-file>ДирективаПуть к файлу PEM с сертификатами центров, по которым узел проверяет сертификат эндпоинта.http-webhook-certificate<acct-file>ДирективаФайл PEM с сертификатом, который узел предъявляет эндпоинту, если тот его запросит.http-webhook-connect-timeout<acct-file>ДирективаПредел ожидания при подключении к эндпоинту вебхука; умолчание пять секунд.http-webhook-io-timeout<acct-file>ДирективаПредел ожидания любой операции обмена с эндпоинтом после установления соединения; умолчание пять секунд.http-webhook-log-verbose<acct-file>ДирективаДобавляет в журнал MTA сообщения об отправке пачек, не только об ошибках; по умолчанию выключена.http-webhook-transfer-encoding<acct-file>ДирективаЕдинственное поддерживаемое значение gzip; по умолчанию содержимое уходит без сжатия.move-interval<acct-file>ДирективаИнтервал перекладывания файла учёта; умолчание сутки, работает только вместе с каталогом назначения.retry-interval<acct-file>ДирективаИнтервал повторного запуска программы, которой отдаются записи; умолчание пять минут, только для формы с каналом.time-first-attempt-hires-timestampGlobalДирективаДописывает миллисекунды к отметке первой попытки в записях учёта; работает только при включённом подсчёте.write-timeout<acct-file>ДирективаПредел ожидания записи в программу, чтобы неотвечающий сборщик не держал узел; умолчание одна минута.pmc-acct-min-free-spaceGlobalДирективаНиже порога MTA начинает удалять самые старые файлы учёта, накопленные для консоли управления; удалённые данные пропадают навсегда.Договор о телеметриикритичноМеханизмОдин блок описывает выход учёта целиком: какие виды записей, какие поля, куда они идут, как сменяются файлы и что обезличивается.Файл, программа или эндпоинт — и файл под каждым из трёхкритичноМеханизмТри способа отдать записи учёта; у эндпоинта под низом всё равно файл, который удаляется только после успешной отправки, а ответ не 2xx вызывает повтор.Как устроена запись учётакритичноМеханизмКак устроена запись учёта: вид записи в первом столбце, дальше поля, состав которых настраивается.Что узел рассказывает о себе и по каким каналамкритичноМеханизмСемь поверхностей наблюдения: веб-монитор, консоль в четырёх форматах, журнал, учёт, поиск по учёту, метрики и выгрузка во внешнюю аналитику.Два обработчика входящих отчётов и что с ними делатьМеханизмОтказы письмом и жалобы разбираются двумя одинаково устроенными блоками; у каждого свой список адресов и своя пара решений о судьбе письма.Форматы ответа монитораМеханизмВеб-монитор отдаёт страницы человеку по адресу с /ui, а программе — XML или JSON по тому же адресу без суффикса.Учёт, отправляемый узлом, вместо учёта, забираемого с узлаМеханизмЗаписи учёта можно отправлять на эндпоинты HTTP в дополнение к файлам и каналу — не вместо них.Отдача показателей сборщикуМеханизмОтдача показателей узла внешнему сборщику в его формате.Форматы вывода командМеханизмКоманды узла умеют печатать не только текст, но и структуру.Метрики узла в стандартном форматеМеханизмУзел отдаёт счётчики, датчики и сводки в общепринятом формате: трафик, соединения, ошибки, глубина очереди и задержки.CSV или JSON — выбирает расширение файла, а не директиваМеханизмЗаписи пишутся как значения через запятую с заголовочной строкой или как объекты JSON по одному на строку; выбор делает расширение в пути.Аналитика вендора — и что уходит с узла ради неёМеханизмПлатная служба, принимающая данные учёта узла и возвращающая аналитику, оценку здоровья и отчёт по спам-ловушкам; включается по областям и выключена, пока нет её блока.Журнал и учёт — два файла и два разных вопросаМеханизмMTA ведёт отдельный журнал и отдельный файл учёта; разделение сделано ради формата, производительности и возможности отдать журнал не раскрывая данные.Пять способов очереди отдать письмоМеханизмОчередь не обязана ходить по SMTP: она умеет писать в файл, запускать программу, стучаться по HTTP или выбрасывать.Отдача показателей по SNMPМеханизмУзел умеет отдавать свои показатели по SNMP — второй способ наблюдения помимо веб-монитора.<acct-file>Блок конфигурацииОдин поток учёта: какие записи и поля он несёт, куда пишется, как часто перекладывается и сколько хранится.<prometheus-listener>Блок конфигурацииБлок поднимает на узле порт, с которого система мониторинга забирает метрики в формате Prometheus; блок на узле может быть только один.show statusкритичноКомандаПечатает состояние узла целиком: трафик, соединения, очередь, спул, лицензию.digestКомандаСчитает хеш заданной строки выбранным способом.reset countersКомандаОбнуляет счётчики статистики, которые показывает show status.rotate acctКомандаНемедленно поворачивает все файлы учёта или один названный; поворот в полночь остаётся.Выполнить команду по сетикритичноТочка APIВыполняет команду консоли узла, переданную запросом, и отдаёт результат структурой или текстом.Отдать файл узлакритичноТочка APIОтдаёт журнал или файл учёта по имени из перечня /logs.Состояние узла целиком одним документомкритичноТочка APIОтдаёт страницу состояния структурой в XML или JSON: продукт, лицензия, машина, трафик, соединения, резолвер, очереди, спул и признак работы — одним ответом.Очереди с наибольшим числом получателейТочка APIОтдаёт верхние очереди — пары «приёмник и адрес отправки» — по числу получателей; параметр queue сужает выборку.Приёмники с наибольшей очередьюТочка APIОтдаёт домены получателей с наибольшей очередью, сложив по каждому все адреса отправки.Доставлено — запись, по которой считают всёкритичноЗапись учётаПишется на каждого получателя, чьё письмо принял сервер назначения: исход, время, адрес отправки, задание, защита передачи и прокси.Счётчики трафикаМетрикаПолучатели, письма и килобайты за всё время, за последний час и за последнюю минуту.ЖурналыкритичноЭкран монитораПеречень файлов журнала и учёта со ссылками на скачивание.Состояние узлаЭкран монитораСостояние узла на одной странице: трафик, пики, соединения с потолком, кэш DNS, спул и очереди по способам доставки.Собственный журнал узлаФайлЖурнал самого MTA: запуск и остановка, ошибки, следы соединений и предупреждения; ротация автоматическая, число хранимых файлов настраивается.