База знаний PMTA›Блок <source>›Директива§ 3.3.7.64

log-connections

<source>Хаб задаёт сам

Записывать ли начало и конец каждого соединения

в конфигурации это строкаlog-connections falseвнутри блока <source>

Первая ступень подробности журнала

Строка добавляет в журнал по записи в начале и в конце каждого соединения от источника. Умолчание — false.

Это самая дешёвая из трёх ступеней подробности. По возрастанию: эта строка — факт соединения; log-commands — весь разговор SMTP; log-data — каждый байт в двух видах. Объём растёт на порядок с каждой ступенью.

Отвечает она на один вопрос: доходит ли до нас подающий вообще. Когда платформа говорит «не могу отправить», а в учёте пусто, эта строка различает два случая: соединение не устанавливается — разбираться надо в сети и в списке источников; устанавливается и сразу закрывается — дело в подаче.

Строка про входящие соединения, потому что живёт в блоке источника. Исходящие соединения к приёмникам этой строкой не пишутся.

Главная ловушка — включить в источнике 0/0. Это все подающие разом, включая собственные проверки узла и любого, кто просто постучался на порт. Объём вырастает непредсказуемо, и нужные записи в нём теряются.

Что делает Хаб. Пишет — явное no в блоке источника, вместе с log-commands и log-data.

Записать умолчание явно — здесь осмысленно: три строки подряд показывают читающему конфигурацию, что ступени подробности известны и выключены сознательно, а не забыты. Рядом в шаблоне стоят предупреждения «verbose» и «even more verbose».

Рекомендуемые значения

Включают точечно и на время:

Значение	Когда
no (умолчание)	обычная работа
yes в узком источнике	разбор одной подающей платформы
yes в 0/0	почти никогда

Умолчание false и то, что запись делается в начале и в конце соединения, — из руководства (§ 3.3.7.64). Лестница из трёх ступеней подробности и предупреждение про 0/0 — наши.

Пример в конфигурации

# разбор одной подающей платформы, а не всех сразу
<source 10.0.0.7>
    log-connections yes</source>

Источник задан узко — одним адресом. В 0/0 та же строка пишет каждое касание порта, включая чужие сканеры.

жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.

▲

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

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

Включают в источнике 0/0 и тонут в записях

наш опыт

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

Как заметитьЖурнал вырос скачком сразу после правки конфигурации.

Как правильноОграничить блок адресом разбираемой платформы.

Совместимость

PowerMTA 6.0

описана в руководстве этой версии · платформа: любая

С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.

Справочные данные

Синтаксис: log-connections <boolean>
Значения: yes | no | true | false
Умолчание: false § 3.3.7.64
Применение: reload, перезапуск не нужен
Очередь: уже поставленное в очередь не затронет
Где писать: <source>
Сколько раз: один раз в блоке

Всё здесь — из руководства, с разделом.

Наследование

Директива живёт в <source> и достаётся тому, чей адрес совпал с блоком; при нескольких подходящих блоках побеждает самое точное совпадение. Соединения к приёмникам эта строка не пишет.

⇄

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

1 связь

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

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

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

Разобраться, почему копится очередь к одному приёмникуТретий круг: запись соединений, включается адресно и убирается сразу. § 4.2.2 Разбор приёма писемДиректива, которую шаг и задаёт. § 4.2.4

Как проверить на узле

Смотрим журнал и делаем одно подключение к порту подачи:

tail -f /var/log/pmta/log

Появятся две строки — открытие и закрытие. Пусто означает, что соединение до узла не дошло: смотреть надо сеть и smtp-listener.

◇

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

3 статьи

◇Что узел рассказывает о себе и по каким каналамСемь поверхностей наблюдения: веб-монитор, консоль в четырёх форматах, журнал, учёт, поиск по учёту, метрики и выгрузка во внешнюю аналитику.◇Сторож, который перезапускает MTAПрисматривает за MTA и после падения поднимает его сам, отправляя отчёт о падении на адрес ответственного.◇Чем опасна виртуальная машинаРаботать на виртуальной машине можно, но руководство не рекомендует это без достаточного железа и выверенных настроек гипервизора: под нагрузкой узел может перестать отвечать.

В Хабе

Управляется: Инфраструктура → Параметры узла
Значение: Хаб подбирает сам — темп, стадия прогрева, метрики
Цена ошибки: безопасно: неверное значение ничего не ломает
Сценарии: Разобрать зависшую очередь

Соседние настройки блока <source>:log-commands trace-dkim-check log-data trace-iprev-check log-tls Все 74 директив блока →