log-verbose

<signals>

Подробная запись о выгрузке в аналитику вендора
в конфигурации это строкаlog-verboseвнутри блока <signals>
Почему события не доходят до аналитики вендора

Строка добавляет в журнал ход выгрузки событий во внешнюю аналитику. Умолчание — выключено.

Тот же приём, что у вебхука учёта. Симптом у неисправностей выгрузки один — события не появляются на той стороне, — а причин много: ключ, адрес, сеть, формат.

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

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

Строку стоит знать при разборе чужого узла, где такая выгрузка настроена.

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

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

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

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

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

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

наш опыт

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

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

наш опыт

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

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

1 связь

Как проверить на узле
Смотрим журнал MTA, отобрав нужные строки:
grep -i "signals" /var/log/pmta/log | tail -20
Появятся сообщения о попытках выгрузки и коды ответов. Пусто означает, что выгрузка не настроена или не запускается вовсе.
В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Разобрать зависшую очередь