http-log-data

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

Записывать ли содержимое обмена с веб-монитором
в конфигурации это строкаhttp-log-data falseвнутри блока Global
Подробная запись обмена — на время разбора

Со значением true монитор пишет обмен с клиентом подробнее, чем http-log-requests. По умолчанию выключено.

Строка диагностическая, а не постоянная. Её включают, когда клиент API получает не тот ответ, которого ждёт, и надо увидеть, что именно ушло и пришло.

🔴 В подробную запись попадает и то, что клиент прислал. Через монитор идут ключи, содержимое правок конфигурации и команды. Журнал с такой записью надо считать хранилищем секретов и обращаться с ним соответственно — а лучше выключать сразу после разбора.

Формулировка в руководстве совпадает с соседней строкой дословно — «whether web monitor data exchanges are logged», — и различает их только приписка «more verbose». Похоже на опечатку вендора в одном из двух разделов.

Главная ловушка — оставить подробную запись включённой. Она и объёмна, и содержит то, чего в журнале быть не должно. Забытая строка превращает журнал монитора в файл, который нельзя показывать наравне с остальными.
Что делает Хаб. Не пишет. Если понадобится разобрать, почему узел отвечает Хабу не так, — включать на время разбора и снимать сразу, помня, что в записи окажется ключ управления.
Рекомендуемые значения

Только на время разбора:

Значение Когда
false (умолчание) всегда
true разбираем непонятный ответ API, на минуты

После разбора журнал стоит просмотреть и решить, не надо ли его удалить: в нём может лежать ключ.

Умолчание false и то, что запись подробнее журнала запросов, — из руководства (§ 3.3.1.58.21). Предупреждение про секреты в записи и совпадение формулировок двух разделов — наши.
Пример в конфигурации
# на минуты разбора, потом снять — в записи окажется ключ
http-mgmt-port 1000
http-log-data true
Строка снимается сразу после разбора. Журнал за это время стоит просмотреть отдельно.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Оставляют подробную запись после разбора

наш опыт

Чем чреватоЖурнал растёт и наполняется тем, чего в нём быть не должно, — ключами и содержимым правок конфигурации.
Как заметитьВ журнале монитора видны заголовки запросов целиком.
Как правильноВернуть false, перезапустить монитор и решить судьбу уже записанного.

Включают подробную запись вместо журнала запросов

наш опыт

Чем чреватоДля вопроса «кто и что делал» достаточно http-log-requests, а подробная запись добавляет объём и секреты без пользы.
Как заметитьПостоянно включена http-log-data, а http-log-requests — нет.
Как правильноПоменять местами: постоянной оставить запись запросов.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
http-log-data <boolean>
Значения
yes | no | true | false
Умолчание
false § 3.3.1.58.21
Применение
нужен перезапуск сервиса
Очередь
уже поставленное в очередь не затронет
Где писать
Global
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Наследования нет: строка пишется в корне файла, раздел Global, и действует на весь управляющий интерфейс.
Как проверить на узле
Открываем журнал монитора и делаем один запрос:
tail -f /var/log/pmta/pmtahttp.log
При включённой подробной записи в строках будет видно содержимое обмена, а не только сам факт обращения. Это и есть признак, что строка применилась.
В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Безопасность узла