customer-id

<signals>

Номер счёта у вендора — строка больше не нужна
в конфигурации это строкаcustomer-idвнутри блока <signals>
Строка, переставшая быть обязательной

Номер счёта, к которому привязан api-key. До PowerMTA 5.5 её требовалось задавать, если отслеживание шло силами MTA. Начиная с 5.5 — не нужна: MTA определяет счёт по ключу сам.

Строка не объявлена устаревшей, но и смысла в ней больше нет. Встречается она в перенесённых конфигурациях и в примерах руководства, которые остались от прежних версий.

Убирать её безопасно — на шестой версии она ни на что не влияет.

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

Решение зависит только от версии:

Версия Строка
до 5.5 обязательна при отслеживании силами MTA
5.5 и выше не нужна, можно убрать
Требование до версии 5.5 и его отмена начиная с 5.5 — из руководства (§ 11.1.6.2.7). Замечание про примеры соседних разделов — наше.
Пример в конфигурации
# так было до 5.5; на шестой версии строку можно убрать
<signals>
    engagement-tracking sparkpost
    customer-id 123</signals>
Примеры соседних разделов руководства до сих пор её показывают — это наследие прежних версий, а не требование.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Держат строку, считая её обязательной

§ 11.1.6.2.7

Чем чреватоНа шестой версии она ничего не делает. Вреда нет, но в конфигурации остаётся строка, которую следующий читатель примет за нужную.
Как заметитьСтрока есть, версия MTA шестая.
Как правильноУдалить.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
customer-id <number>
Значения
номер счёта у вендора
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<signals>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Наследования нет: строка живёт внутри <signals>, а такой блок на узле один.
Как проверить на узле
Найти строку в конфигурации и убедиться, что версия шестая:
grep -rn "customer-id" /etc/pmta/ ; pmta show version 2>/dev/null | head -2
На версии 5.5 и выше строку можно удалить без последствий.
В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Подготовить узел к отправке