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

Очереди с наибольшим числом получателей

/queues
Верхушка, а не весь список

Отдаёт очереди — пары «приёмник и адрес отправки» — со счётчиками: то же, что страница «Топ очередей» монитора, только структурой.

Вызов — GET /queues?format=json (или xml). Параметр queue сужает выборку парой «домен/адрес», и любая половина может быть звёздочкой: queue=*/vmta1 — очереди одного адреса отправки. Отдельной точки для адреса отправки руководство не заводит — его подробности описаны именно так.

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

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

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

И это снимок: очередь, побывавшая в щадящем режиме между двумя запросами, в ответ не попадёт.

Что делает Хаб. Спрашивает дважды. Опрос узла раз в минуту берёт /queues?format=json&maxItems=1 вместе с /status — для телеметрии нужен только итог, а он от длины не зависит. Экран «Мониторинг PMTA» берёт точку вместе с /domains, /vmtas и /jobs и передаёт длину maxItems=1000.

Число очередей с письмами экран берёт из итога totalQueuesWithRcp, а не считает по строкам; если строк пришло ровно тысяча, экран говорит, что список урезан. Очереди на паузе и в щадящем режиме Хаб отдельно спрашивает командами через /command — с –maxitems=10000.

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

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

Вопрос Она ли
какие очереди сейчас самые большие да
очереди одного адреса отправки да — queue=*/адрес, но тоже верхушкой
все очереди узла без исключения нет — show queues с –maxitems
история одной очереди нет — /queueDetail
что было вчера нет — это учёт
Параметр queue со звёздочками, страница «Топ очередей», длина и порядок списка, потолок команды в двадцать очередей — из руководства (§ 5.4, § 5.9, § 3.3.1.58.23–24, § 6.3.14). Разграничение вопросов и вывод про подсчёт по строкам — наши.
Пример в конфигурации
# верхние очереди и очереди одного адреса отправки
curl -s 'http://127.0.0.1:8080/queues?format=json'curl -s 'http://127.0.0.1:8080/queues?format=json&queue=*/vmta1'
Вторая строка сужает выборку одним адресом отправки — так руководство и описывает его подробности. Длина ответа в обоих случаях — http-default-max-items.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
⇄

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

2 связи

Зависит от

Очередь — это приёмник вместе с адресом отправкиМеханизм, который здесь и виден. § 5.9

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

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

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

Адреса отправки, у которых есть очередьСмежная запись каталога. § 5.9

Как проверить на узле
Сравнить, сколько очередей пришло и сколько их на узле:
curl -s 'http://127.0.0.1:8080/queues?format=json' | head -60
pmta show queues --maxitems=1000 --no-rcpt-events
Если консоль перечисляет больше очередей, чем пришло в ответе, — это верхушка по http-default-max-items, а не расхождение данных.
◇

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

3 статьи

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

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