Web Analytics

Web Analytics собирает pageviews и Web Vitals для каждого домена, для которого он включён. Данные хранятся в вашем ClickHouse — в self-hosted они не покидают вашу инфраструктуру, в cloud деплойментах хранятся в control plane Skitflow Cloud.

Включение аналитики для домена

1. Откройте Web Analytics в сайдбаре dashboard и выберите приложение или Compose стек в селекторе.
2. Карточка Domains покажет домены этого ресурса, у каждого свой переключатель.
3. Включите переключатель для нужного домена. Skitflow создаст siteId для него и перерендерит конфигурацию Traefik, подключив inject middleware для аналитики.

Отключение домена запускает тот же рендер Traefik и отсоединяет middleware. siteId сохраняется, поэтому повторное включение того же домена не ломает уже настроенные сниппеты.

Сниппет beacon вручную

После включения домена карточка Domains показывает копируемый сниппет, построенный из его siteId:

<script defer src="<skitflow-url>/va.js" data-site="<siteId>"></script>

Вставьте это в <head> страницы отслеживаемого сайта. Это обязательно — не опционально — для доменов Compose и приложений Kubernetes, поскольку auto-inject для них никогда не запускается; для обычных приложений на Traefik это запасной вариант на случай, если флаг auto-inject выключен.

Необходимое разрешение: observability.manage

API endpoints:

POST /api/trpc/webAnalytics.enable   { "domainId": "<id>" }
POST /api/trpc/webAnalytics.disable  { "domainId": "<id>" }
GET  /api/trpc/webAnalytics.status?input={"domainId":"<id>"}

status возвращает { enabled: boolean, siteId: string | null }.

Retention

Web Analytics использует тот же период retention, что настроен в Observability Settings (по умолчанию: 30 дней). Параметр from в каждом запросе автоматически ограничивается значением now − retentionDays — запросы за данными старше окна retention возвращают пустой результат, а не ошибку.

Сырые события pageview и Web Vitals хранятся в ClickHouse с TTL 90 дней. Часовые pre-aggregated rollups обеспечивают эффективные app-wide запросы в пределах окна retention.

Данные dashboard

getAnalytics получает все одиннадцать карточек dashboard в одном запросе:

API endpoint: GET /api/trpc/webAnalytics.getAnalytics

Обязательный input: { appId, from, to } — строки ISO 8601 datetime для from/to. Опционально: serviceName (см. Per-service scope).

Необходимое разрешение: observability.read

Сводка метрик

getMetrics возвращает список top paths и сводку p75 Web Vitals в одном запросе — более лёгкая альтернатива getAnalytics, когда нужны только эти две карточки.

API endpoint: GET /api/trpc/webAnalytics.getMetrics

Timeseries просмотров

getViewsTimeseries возвращает почасовой ряд views-over-time для одного сервиса. Вид «Compare» разворачивает это в несколько запросов — по одному на каждый compose сервис — и накладывает ряды как цветные линии.

API endpoint: GET /api/trpc/webAnalytics.getViewsTimeseries

Timeseries Web Vitals

getVitalsTimeseries возвращает p75 Web Vitals с разбивкой по времени. Ширина bucket настраивается в целых часах (1–24); по умолчанию 1 ч — нативная гранулярность rollup.

API endpoint: GET /api/trpc/webAnalytics.getVitalsTimeseries

Оценки Web Vitals классифицируются как good, needs-improvement или poor по стандартным порогам Core Web Vitals.

Per-service scope

Все read endpoints принимают опциональный параметр serviceName, который ограничивает результаты одним compose сервисом. Compose сервис может владеть несколькими доменами, поэтому фильтр резолвится в набор значений siteId для аналитически включённых доменов этого сервиса.

• Без serviceName возвращаются app-wide данные по всем доменам из pre-aggregated 1 ч rollup.
• Если у сервиса нет доменов с включённой аналитикой, возвращается пустой результат — не происходит fall back к app-wide данным.

Per-service запросы обращаются к сырым таблицам pageview_events / web_vitals_events (rollup не хранит site_id), но всё равно ограничены тем же окном retention, что и любой другой запрос. TTL 90 дней сырых данных — это лишь физический потолок: в self-hosted он уменьшается до настроенного значения retention, если оно меньше 90 дней.

Собираемые данные

Каждое событие pageview записывает:

Каждое событие Web Vitals записывает имя метрики, значение, рейтинг, path и тип устройства. Сырой IP клиента не сохраняется.

Privacy

IP-адреса клиентов хешируются (SHA-256, обрезка до 16 hex-символов) перед сохранением — в ClickHouse записывается только хеш, сырой IP никогда. Cookies и fingerprinting не используются. В self-hosted установках все данные остаются на вашей инфраструктуре.

Связанные разделы

• Observability
• Monitoring
• Domains