http-default-sort-order

Globalнужен перезапуск

Как сортировать списки «Топ» веб-монитора
в конфигурации это строкаhttp-default-sort-order rcptвнутри блока Global
По чему считается «топ»

Строка задаёт, что означает слово «топ» на четырёх страницах списков и в таблице на главной. Три значения: rcpt — по числу получателей, по убыванию; name — по имени, по алфавиту; size — по объёму в килобайтах, по убыванию. Умолчание — rcpt.

Выбор меняет ответ, а не только вид. Список по получателям и список по объёму показывают разные верхушки: рассылка на сто тысяч коротких писем и рассылка на тысячу тяжёлых стоят в них в разном порядке. Смотреть очередь по объёму имеет смысл тогда, когда узел упёрся в канал, а не в приёмник.

Значение name не «топ», а просто список — по алфавиту, без всякого ранжирования. Полезно, когда ищут конкретный домен глазами.

Главная ловушка — читать список по получателям как список по нагрузке. Приёмник, к которому уходит немного тяжёлых писем, в сортировке по умолчанию окажется внизу — и именно он может держать канал.
Что делает Хаб. Не пишет — остаётся rcpt. Экран «Мониторинг PMTA» берёт списки этими страницами с длиной 1000, так что порядок решает, что останется за пределами списка, только на очень больших узлах: туда уйдут очереди с наименьшим числом получателей.
Рекомендуемые значения

Значение выбирают по вопросу, который задают списку:

Значение Отвечает на вопрос
rcpt (умолчание) куда уходит больше всего писем
size что занимает канал
name где в списке нужный домен
Три значения, их смысл и умолчание rcpt — из руководства (§ 3.3.1.58.24). Замечание о том, что сортировка меняет ответ, а не вид, — наше.
Пример в конфигурации
# узел упирается в канал, а не в приёмник — смотрим по объёму
http-mgmt-port 1000
http-default-sort-order size
Настройка касается только страниц монитора. Порядок в выдаче для своих программ задаётся запросом.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

Типичные ошибки и проблемы

что делают не так и чем это кончается1 ошибка▶

Ищут виновника канала в списке по получателям

наш опыт

Чем чреватоСортировка по умолчанию ранжирует по числу писем. Приёмник с немногими тяжёлыми письмами в неё не попадёт, хотя занимает канал.
Как заметитьВерхушка списка выглядит обычной, а канал занят.
Как правильноПереключить на size — или запросить выдачу с нужным порядком, не меняя настройку узла.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
http-default-sort-order <enumeration>
Значения
rcpt | name | size
Умолчание
rcpt § 3.3.1.58.24
Применение
нужен перезапуск сервиса
Очередь
уже поставленное в очередь не затронет
Где писать
Global
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Наследования нет: строка пишется в корне файла, раздел Global, и действует на все списки «Топ» сразу.
Как проверить на узле
Смотрим порядок в выдаче — он тот же, что на странице:
curl -s 'http://NODE:1000/domains?format=json' | head -c 400
Порядок записей в ответе и есть действующая сортировка. Сверьте первую запись с тем, что ожидаете от выбранного значения.
В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Безопасность узла