Подробности одной очереди

критично

/queueDetail
Три коротких истории

Отдаёт одну очередь вместе с её короткими историями — то же, что страница очереди в мониторе: последние 50 событий получателей, последние 10 ошибок очереди и последние 10 смен режима между обычным и щадящим.

Вызов — GET /queueDetail?format=json&queue=домен/адрес. Звёздочек для этой точки руководство не показывает: она описывает одну очередь, выборку даёт /queues.

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

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

Главная ловушка — искать здесь давнюю историю. Истории короткие: полсотни событий и по десятку ошибок и смен режима. Что было утром на загруженной очереди, отсюда уже не видно — это вопрос к учёту.
Что делает Хаб. Не спрашивает. Смены режима он восстанавливает сам: раз в пять минут спрашивает у узла командой через /command, какие очереди сейчас в щадящем режиме, и складывает эпизоды из появления и пропажи очереди в этом списке. Короткий заход между двумя обходами при этом пропадает — а здесь он был бы виден.
Рекомендуемые значения

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

Вопрос Она ли
почему именно эта очередь стоит да — последние ошибки
когда очередь уходила в щадящий режим да, в пределах десяти последних смен
какие очереди большие нет — /queues
что было вчера нет — это учёт
Состав историй и форма параметра queue — из руководства (§ 5.4). Выводы про глубину историй и разграничение вопросов — наши.
Пример в конфигурации
# одна очередь с её историями
curl -s 'http://127.0.0.1:8080/queueDetail?format=json&queue=gmail.com/vmta1'
Пара пишется полностью: домен получателя и имя адреса отправки. Выборку со звёздочками даёт /queues.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Как проверить на узле
Сверить ответ с консолью:
curl -s 'http://127.0.0.1:8080/queueDetail?format=json&queue=gmail.com/vmta1' | head -60
pmta show queues --mode-events gmail.com/vmta1
Если консоль очередь видит, а запрос нет, — проверить написание пары: имя адреса отправки должно совпадать с конфигурацией.
В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Разобраться с доставляемостью · Настроить темп под провайдера
Важность
критично