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

log-requests

<transmissions-api>

Записывать ли обращения к API подачи
в конфигурации это строкаlog-requests falseвнутри блока <transmissions-api>
Кто и когда подавал письма по HTTP

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

Это единственный след подачи по HTTP. Ключей подачи может быть несколько (api-key повторяется), и без этой строки нельзя ответить на вопрос, кто именно и когда подавал.

Ступень ниже, чем log-data: здесь факт запроса, там его содержимое.

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

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

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

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

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

Ждут следа подачи по HTTP без этой строки

наш опыт

Чем чреватоУчёт покажет принятые письма, но не то, чьим ключом они поданы. Ответить на вопрос «кто это отправил» будет нечем.
Как заметитьПисьма появились, источник неизвестен.
Как правильноВключить запись заранее — задним числом она не поможет.

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

наш опыт

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

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

1 связь

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

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

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

log-data<transmissions-api>Ступень ниже: там факт запроса, здесь его содержимое. § 3.3.20.3log-tls<transmissions-api>Обе пишут в журнал MTA: эта про рукопожатие, та про сами запросы. § 3.3.20.2

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

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

3 статьи

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

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