Demo
Demo
База знаний PMTA›Блок Global›Директива§ 3.3.1.58.22

http-log-requests

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

Записывать ли запросы к веб-монитору в журнал
в конфигурации это строкаhttp-log-requests falseвнутри блока Global
Кто и что спрашивал у монитора

Со значением true монитор пишет в свой журнал обращения к нему. По умолчанию выключено, то есть по умолчанию следа обращений к управляющему интерфейсу не остаётся.

Журнал у монитора свой — /var/log/pmta/pmtahttp.log, отдельный от журнала MTA. Туда же попадают отказы по http-access, и они пишутся независимо от этой строки.

Это единственный способ узнать, что делали через API. Команды, поданные по HTTP, и правки конфигурации через интерфейс не оставляют иного следа: журнал MTA их не показывает. Там, где ключ выдан нескольким приложениям, без этой строки нельзя ответить на вопрос «кто остановил очередь».

Формулировка руководства для этой строки и для http-log-data совпадает дословно — «whether web monitor data exchanges are logged». Судя по тому, что вторая описана как «более подробная», здесь пишутся сами запросы, а там ещё и их содержимое.

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

Решение зависит от того, у скольких людей есть ключ:

Значение Когда
false (умолчание) к монитору ходит только Хаб
true ключ выдан людям или нескольким приложениям

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

Умолчание false — из руководства (§ 3.3.1.58.22). Имя журнала монитора — из § 3.3.1.58.3, его каталог задаёт строка log-file (§ 3.3.1.59.2). Что это единственный след действий по API, и совет включать заранее — наши.
Пример в конфигурации
# след действий, поданных ключом: включать до происшествия, не после
http-mgmt-port 1000
http-log-requests true
Строка отвечает на вопрос «кто это сделал». Заданная после происшествия, она на него уже не ответит.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Ищут обращения к API в журнале MTA

наш опыт

Чем чреватоУ монитора отдельный журнал. В /var/log/pmta/log этих строк не будет никогда, сколько ни включай.
Как заметитьСтрока включена, а в привычном журнале ничего не изменилось.
Как правильноСмотреть /var/log/pmta/pmtahttp.log.

Включают запись после происшествия

наш опыт

Чем чреватоПрошлые обращения не восстанавливаются. Ответа на вопрос «кто это сделал» не будет вовсе.
Как заметитьЖурнал начинается с момента, когда стали разбираться.
Как правильноВключать заранее — там, где ключ есть у людей, а не только у программы.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
http-log-requests <boolean>
Значения
yes | no | true | false
Умолчание
false § 3.3.1.58.22
Применение
нужен перезапуск сервиса
Очередь
уже поставленное в очередь не затронет
Где писать
Global
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Наследования нет: строка пишется в корне файла, раздел Global, и действует на весь управляющий интерфейс. Выборочно — по адресу или по ключу — запись не включается.
⇄

Связанные директивы

1 связь

Где применяется

http-mgmt-portGlobalОдна из настроек того самого интерфейса, который слушает этот порт. § 3.3.1.58.22

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

http-log-tlsGlobalОбе пишут в собственный журнал монитора: эта про рукопожатие, та про запросы. inferencehttp-log-dataGlobalТот же журнал, на шаг подробнее. § 3.3.1.58.21

Как проверить на узле
Открываем журнал монитора и делаем один запрос:
tail -f /var/log/pmta/pmtahttp.log
При включённой записи появится строка обращения. Пусто — либо строка не применилась (монитор надо перезапустить), либо смотрите не тот файл: журнал монитора отдельный от журнала MTA.
◇

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

3 статьи

◇Кому разрешено сдавать почту и для кого её приниматьИз коробки узел принимает подачу только с самой машины; два разных вопроса — «кто может слать через нас» и «на чьи адреса мы принимаем» — решаются разными директивами.◇Группа, дающая право управлятьЧленство в группе pmta даёт непривилегированному пользователю право звать команды узла и пользоваться подачей.◇Как узел выбирает источник и складывает его настройкиСоединение попадает под все блоки источника, чьи адреса его накрывают, и действуют они слитно — узкий перекрывает широкий; именованные блоки подключаются только по прямой ссылке.

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Безопасность узла
Соседние настройки блока Global:log-filelog-rotatelog-auto-rotationdummy-smtp-await-slotdummy-smtp-portВсе 108 директив блока →