База знаний PMTA›Точка API§ 5.5

Приёмники с наибольшей очередью

/domains

Адреса сложены, список урезан

Отдаёт домены получателей, сложив по каждому все адреса отправки: число получателей, объём, открытые соединения и последнюю ошибку доставки.

Вызов — GET /domains?format=json (или xml). Подробности одного домена — отдельной точкой /domainDetail.

Это верхушка «Топ доменов»: длину задаёт http-default-max-items, по умолчанию десять строк, порядок — http-default-sort-order.

Числа не совпадут с суммой по /queues, и это не ошибка: там та же почта разложена по парам, и обе верхушки срезают разное.

Доступ решает http-access по адресу, откуда пришёл запрос, — для чтения хватает уровня monitor. Ключ из http-api-key в заголовке X-API-Key даёт полный доступ с любого адреса.

Главная ловушка — считать по строкам. Ответ по умолчанию несёт десять доменов: «на скольких приёмниках ошибки» или «сколько доменов в очереди», посчитанные по строкам, описывают только верх списка. Команда show domains режет тоже — по умолчанию двадцать строк, — полный перечень берут с –maxitems.

Что делает Хаб. Спрашивает — экран «Мониторинг PMTA» берёт эту точку вместе с /status, /queues, /vmtas и /jobs и передаёт длину maxItems=1000. Число доменов в очереди экран берёт из итога totalDomainsWithRcp; если строк пришло ровно тысяча, под списком написано, что он урезан. Опрос для телеметрии эту точку не берёт.

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

О чём спрашивать эту точку:

Вопрос	Она ли
к каким приёмникам больше всего почты	да
где сейчас ошибки доставки	да, но только среди верхних
все домены в очереди	нет — show domains с –maxitems
что было вчера	нет — это учёт

Состав строки, страница «Топ доменов», длина и порядок списка, потолок команды в двадцать доменов — из руководства (§ 5.5, § 3.3.1.58.23–24, § 6.3.13). Разграничение вопросов наше.

Пример в конфигурации

# верхние приёмники структурой
curl -s 'http://127.0.0.1:8080/domains?format=json'

Строк в ответе столько, сколько задано http-default-max-items; по умолчанию — десять.

жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.

Совместимость

PowerMTA 6.0

описана в руководстве этой версии · платформа: любая

С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.

⇄

Связанные записи

1 связь

Чем можно заменить

Приёмники, сложенные по всем адресам отправкиЭкран, показывающий то же самое человеку. § 5.5

Как проверить на узле

Сравнить верхушку с полным перечнем:

curl -s 'http://127.0.0.1:8080/domains?format=json' | head -60
pmta show domains --maxitems=1000

Консоль с большим –maxitems перечисляет все домены в очереди; разница в числе строк — длина верхушки, а не потеря данных.

◇

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

3 статьи

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

В Хабе

Цена ошибки: безопасно: неверное значение ничего не ломает
Сценарии: Собрать телеметрию