Demo
Demo
База знаний PMTA›Блок <transmissions-api>›Директива§ 3.3.20.3

log-data

<transmissions-api>

Записывать ли содержимое обмена при подаче по HTTP
в конфигурации это строкаlog-data falseвнутри блока <transmissions-api>
То же имя ещё 1:<source><transmissions-api>— часть из них другие настройки, часть та же самая
Подробности подачи по HTTP

Строка добавляет в журнал содержимое обмена при обработке запросов Transmissions API. Умолчание — выключено.

Подробнее, чем log-requests: та строка пишет сам факт запроса, эта — то, что в нём пришло.

🔴 А приходит в запросе письмо целиком — тело JSON с получателями и содержимым. Журнал с такой записью надо считать хранилищем переписки и обращаться с ним соответственно.

Главная ловушка — оставить включённой после разбора. Строка не ломает ничего и потому переживает разбор: журнал растёт, ротация ускоряется, и записи за прошлую неделю вытесняются раньше, чем понадобятся.
Что делает Хаб. Не пишет: подача у нас идёт по SMTP, блока API в конфигурации нет. Одноимённая строка в <source> — про подачу по SMTP, и её мы держим выключенной явно.
Рекомендуемые значения

Включают на время разбора и выключают после:

Значение Когда
no (умолчание) обычная работа
yes разбираем, что именно прислал подающий клиент API
Умолчание и предмет записи — из руководства (§ 3.3.20.3). Порядок разбора и предупреждение про объём — наши.
Пример в конфигурации
# на время разбора
<transmissions-api …>
    log-data true</transmissions-api>
После разбора строку убирают. При правках через Хаб она и так исчезнет при следующем применении конфигурации.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Оставляют включённой после разбора

наш опыт

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

Ищут эти записи в файле учёта

наш опыт

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

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

2 связи

Чем можно заменить

log-requests<transmissions-api>Ступень ниже: там факт запроса, здесь его содержимое. § 3.3.20.3

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

log-fileGlobalЗаписи ложатся в тот самый журнал, который задан там. inference

Как проверить на узле
Смотрим журнал MTA, отобрав нужные строки:
grep -i "transmissions\|api" /var/log/pmta/log | tail -20
Записи появятся при обращениях к API подачи. Пусто означает, что до узла запросы не доходят вовсе.
◇

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

3 статьи

◇Как письмо попадает в MTAШесть описанных способов подачи: расширенный SMTP, четыре языковые обвязки и каталог, за которым узел следит на диске.◇Кому разрешено сдавать почту и для кого её приниматьИз коробки узел принимает подачу только с самой машины; два разных вопроса — «кто может слать через нас» и «на чьи адреса мы принимаем» — решаются разными директивами.◇Заголовки, которыми отправитель управляет доставкойШесть служебных заголовков позволяют подающей стороне выбрать поток, пометить письмо заданием, задать настройки и ключ подписи, идентификатор конверта и расписание; каждый разрешается отдельно и по источникам.

В Хабе
Управляется
Инфраструктура → Параметры узла
Цена ошибки
обратимо: вредит, пока стоит
Сценарии
Подключить платформу отправки
Соседние настройки блока <transmissions-api>:log-requestslog-tlsapi-keymax-message-sizeВсе 5 директив блока →