ws/ArchiveReferers

Коллекция переходов клиентов на внешние хосты веб-сервера платформы: откуда пришел клиент (заголовок Referer, utm-метки), какой URL открыл, IP-адрес и браузер.

Заполняется микросервисом ws для маршрутов внешних хостов ws/ExternalRoutedHosts, у которых включен режим archive_referers (в записи или в маршруте).

Сохраняются только переходы — GET-запросы, удовлетворяющие одному из условий:

заголовок Referer указывает на другой хост;
в запросе есть параметры utm_*;
заголовка Referer нет, и запрос — переход на страницу (заголовок Sec-Fetch-Dest: document или Accept, содержащий text/html).

Внешний Referer браузер передает однократно — в первом запросе; ресурсы страницы и внутренние переходы идут с Referer своего хоста и не сохраняются.

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

Только в мастер-домене.

Тип хранилища: history или transactionlog. Срок хранения не ограничивается коллекцией: устаревшие партиции удаляются средствами хранилища.

Table 1. Поля класса
Поле	Тип	Описание
`id`	`uuid`	Идентификатор
`dt`	`datetime`	Время запроса, UTC. Поле партиционирования.
`ip`	`string`	IP-адрес клиента (с учетом PROXY protocol и X-Forwarded-For от доверенных адресов).
`host`	`string`	Хост запроса (заголовок Host). Отличается от `item_host` для записи с хостом `*`.
`item_host`	`string`	Значение `host` записи ws/ExternalRoutedHosts.
`item_id`	`uuid`	Идентификатор записи ws/ExternalRoutedHosts, которой принадлежит маршрут.
`route_type`	`string`	Тип обработчика маршрута (`handler`): static, redirect, redirect_regex, error, proxy_http, proxy_websocket, proxy_http_ex, proxy_websocket_ex.
`route_path`	`string`	Шаблон пути маршрута.
`method`	`string`	Метод запроса (GET).
`path`	`string`	Путь запроса к веб-серверу платформы.
`url`	`string`	Открытый URL. В режиме `utm` — без параметров query, кроме `utm_*`; в режиме `full` — с полным query. До 2048 символов.
`utm`	`any`	Все параметры `utm_*` запроса (объект). null, если меток нет.
`utm_source`	`string`	Значение `utm_source`.
`utm_medium`	`string`	Значение `utm_medium`.
`utm_campaign`	`string`	Значение `utm_campaign`.
`referer`	`string`	Заголовок Referer. До 2048 символов. null, если не передан.
`user_agent`	`string`	Заголовок User-Agent. До 512 символов.