Demo
Demo
База знаний PMTA›Блок <signals>›Директива§ 11.1.6.2.2

upload-url

<signals>

Адрес службы, на который уходят данные
в конфигурации это строкаupload-url адрес приёма данных у поставщикавнутри блока <signals>
Куда именно уходят ваши данные

Адрес, на который узел отправляет данные учёта. Умолчание — адрес службы вендора, https://api.sparkpost.com/api/v1/ingest/events.

Задавать её обычно не нужно. Умолчание верно для основного случая; строка существует ради частных установок и, вероятно, ради европейского размещения.

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

Главная ловушка — не заметить, что данные покидают периметр. Это одна из двух поверхностей узла, отдающих наружу содержимое учёта (вторая — вебхук блока учёта): адреса получателей, ответы приёмников, темы при включённом отслеживании. Обезличить их можно только privacy-policy, и то частично.
Что делает Хаб. Не пишет: выгрузкой во внешнюю аналитику мы не пользуемся. События парка приходят к нам напрямую, вебхуком учёта, и отдавать их наружу незачем.
Рекомендуемые значения

Выбор здесь короткий:

Значение Когда
не задавать (умолчание) обычный случай
свой адрес частная установка службы
Умолчание и то, что состав выгружаемых данных MTA выбирает сам, — из руководства (§ 11.1.6, § 11.1.6.2.2).
Пример в конфигурации
# умолчание, записанное явно
<signals>
    api-key 0123456789abcdef012345678901234567890123
    upload-url https://api.sparkpost.com/api/v1/ingest/events</signals>
Записывать умолчание стоит там, где важно, чтобы адрес был виден читающему конфигурацию.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Меняют адрес, не сверив его со службой

наш опыт

Чем чреватоДанные уйдут в никуда и накопятся на диске, пока не сработает порог свободного места — а тогда будут удалены безвозвратно.
Как заметитьФайлы выгрузки копятся, в аналитике пусто.
Как правильноВернуть умолчание либо сверить адрес с документацией службы.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
upload-url <url>
Значения
адрес вида https://…
Умолчание
адрес приёма данных у поставщика § 11.1.6.2.2
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<signals>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Наследования нет: строка живёт внутри <signals>, а такой блок на узле один. Охват выгрузки по потокам задаётся не здесь, а строкой enable-signals с тремя уровнями.
Как проверить на узле
Куда уходят данные, видно по соединениям узла:
ss -tnp | grep -i pmta | head
Исходящие соединения на адрес службы означают, что выгрузка идёт. Отсутствие — что она не настроена либо не может достучаться.
◇

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

3 статьи

◇Кому разрешено сдавать почту и для кого её приниматьИз коробки узел принимает подачу только с самой машины; два разных вопроса — «кто может слать через нас» и «на чьи адреса мы принимаем» — решаются разными директивами.◇Группа, дающая право управлятьЧленство в группе pmta даёт непривилегированному пользователю право звать команды узла и пользоваться подачей.◇Как узел выбирает источник и складывает его настройкиСоединение попадает под все блоки источника, чьи адреса его накрывают, и действуют они слитно — узкий перекрывает широкий; именованные блоки подключаются только по прямой ссылке.

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Безопасность узла
Соседние настройки блока <signals>:customer-idprivacy-policyhtml-edit-error-modecustom-message-id-headerengagement-trackingВсе 16 директив блока →