Перечень журналов и файлов учёта

/logs
Список файлов, а не их содержимое

Перечисляет файлы журнала и учёта, доступные на узле, — то, что страница «Журналы» монитора показывает со ссылками на скачивание.

Вызов — GET /logs?format=json (или xml).

Содержимого файлов здесь нет — только перечень. Сам файл отдаёт /getFile по имени из этого списка.

Журналы можно закрыть отдельно: уровень monitor в http-access с оговоркой deny-logs оставляет монитор и закрывает журналы.

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

Главная ловушка — ждать здесь сам журнал. Точка отвечает перечнем имён, и разбор, рассчитанный на строки журнала, получит список файлов. Строки приходят вторым запросом — /getFile.
Что делает Хаб. Не спрашивает: учёт приходит в Хаб потоком через вебхук, а журналы MTA по сети он не забирает.
Рекомендуемые значения

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

Вопрос Она ли
какие журналы и файлы учёта есть на узле да
что написано в журнале нет — /getFile
что было вчера по письмам нет — это учёт
Назначение страницы, скачивание файла по имени и оговорка deny-logs — из руководства (§ 5.11, § 3.3.1.58.3). Разграничение вопросов наше.
Пример в конфигурации
# перечень файлов, затем один файл по имени
curl -s 'http://127.0.0.1:8080/logs?format=json'curl -s 'http://127.0.0.1:8080/getFile?file=log.txt' -o log.txt
Имя для второго запроса берут из перечня: /getFile отдаёт файл по имени, а не ищет его.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Как проверить на узле
Проверить, открыты ли журналы адресу запроса:
curl -s -o /dev/null -w "%{http_code}\n" 'http://127.0.0.1:8080/logs?format=json'
grep -n 'http-access' /etc/pmta/config
Код 403 при открытом мониторе — проверить, нет ли у адреса запроса оговорки deny-logs.
В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Разобрать зависшую очередь