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

Документ описывает формат событий RUM, основанный на схеме rum-events-format:

• Браузер — атрибуты, реально отправляемые Browser SDK версии 7.2.0. Описаны в основных разделах ниже.
• Мобильные приложения (Android, iOS и кросс-платформенные SDK) — атрибуты, специфичные для мобильных агентов, вынесены в отдельный раздел Мобильные приложения (Android / iOS).

Часть атрибутов формируется на стороне сервера приёма данных по тому, что отправил SDK (IP-адрес и заголовок User-Agent → геолокация, ОС, устройство, браузер; URL → его составные части). Такие атрибуты помечены как (вычисляется на сервере). Для мобильных агентов сведения об устройстве и ОС отправляются SDK напрямую (см. мобильный раздел).

На этой странице:

• Общие атрибуты событий
  • Приложение и сборка
  • Пользователь
  • Сетевое подключение (Connectivity)
  • Флаги функциональности (Feature Flags)
  • Глобальный контекст
• Атрибуты сессии
• Атрибуты просмотра (View)
  • Таймеры и метрики производительности View
  • Core Web Vitals
  • Прокрутка (Scroll)
  • Счётчики View
• Атрибуты ресурсов (Resource)
  • Таймеры загрузки ресурсов
  • Свойства ресурсов
  • Провайдер ресурсов
• Атрибуты GraphQL
• Атрибуты действий (Action)
  • Таймеры и счётчики действий
  • Свойства действий
• Атрибуты Long Tasks
• Атрибуты ошибок (Error)
• Сигналы фрустрации
• UTM-параметры
• Устройство
• Операционная система
• Браузер (User Agent)
• Геолокация
• Дисплей
• Мобильные приложения (Android / iOS)
  • Источник события
  • Устройство и ОС (мобильные)
  • Доступность (Accessibility)
  • Сетевое подключение (мобильное)
  • Мобильные метрики производительности View
  • Мобильные действия (Action)
  • Ошибки и сбои (Error / Crash)
  • Vital-события

Общие атрибуты событий

Эти атрибуты прикрепляются ко всем событиям RUM (view, resource, action, long task, error).

Приложение и сборка

Пользователь

Заполняются, если приложение вызывает setUser(). Допускают произвольные дополнительные поля.

Атрибуты usr.* добавляются через API:

POBP_RUM.setUser({
  id: '1234',                 // обязательное поле
  name: 'John Doe',           // → usr.name
  email: 'john@example.com',  // → usr.email
  plan: 'premium',            // произвольные доп. поля сохраняются как есть
})

POBP_RUM.setUserProperty('plan', 'premium') // добавить/изменить одно поле
POBP_RUM.getUser()                          // получить текущего пользователя
POBP_RUM.clearUser()                        // очистить пользователя

usr.anonymous_id собирается автоматически (trackAnonymousUser по умолчанию true). Чтобы отключить: POBP_RUM.init({ trackAnonymousUser: false }).

Сетевое подключение (Connectivity)

Флаги функциональности (Feature Flags)

Значения feature flags добавляются через API:

POBP_RUM.addFeatureFlagEvaluation('new_checkout', true) // → feature_flags.new_checkout

По умолчанию значения прикрепляются к событиям View и Error. Чтобы добавлять их также к другим типам событий, перечислите их в init:

POBP_RUM.init({
  // ...
  trackFeatureFlagsForEvents: ['action', 'resource', 'long_task', 'vital'],
})

Глобальный контекст

Произвольные пары ключ/значение, которые прикрепляются ко всем последующим событиям в поле context.*.

POBP_RUM.setGlobalContext({ team: 'billing', tier: 'pro' }) // задать весь контекст
POBP_RUM.setGlobalContextProperty('tier', 'pro')            // одно поле → context.tier
POBP_RUM.removeGlobalContextProperty('tier')                // удалить одно поле
POBP_RUM.getGlobalContext()                                 // получить текущий контекст
POBP_RUM.clearGlobalContext()                               // очистить контекст

Атрибуты сессии

Атрибуты пользовательской сессии — агрегированные данные по всей сессии пользователя.

Атрибуты сессии агрегируются на сервере из потока событий просмотров.

Атрибуты первого просмотра сессии:

Атрибуты последнего просмотра сессии:

Атрибуты просмотра (View)

Атрибуты отдельного просмотра страницы.

Таймеры и метрики производительности View

Имя просмотра и пользовательские тайминги задаются через API:

POBP_RUM.setViewName('Checkout')        // → view.name
POBP_RUM.addTiming('first_interaction') // → view.custom_timings.first_interaction

Core Web Vitals

Метрики Web Vitals доступны по пути view.performance.*:

Устаревшие «плоские» атрибуты (view.largest_contentful_paint, view.first_contentful_paint, view.interaction_to_next_paint, view.cumulative_layout_shift и соответствующие *_target_selector / *_time) по-прежнему отправляются для обратной совместимости, но являются устаревшими — используйте view.performance.*. Метрика First Input Delay (FID) больше не собирается Browser SDK; используйте INP.

Прокрутка (Scroll)

Счётчики View

Атрибуты ресурсов (Resource)

Данные о загрузке ресурсов (документ, CSS, JavaScript, изображения, шрифты, XHR/Fetch, beacon и др.).

Таймеры загрузки ресурсов

У каждой фазы также доступно поле .start — смещение начала фазы относительно начала запроса.

Свойства ресурсов

Провайдер ресурсов

Атрибуты GraphQL

Доступны при использовании GraphQL API в веб-приложении.

Сбор метаданных GraphQL включается параметром allowedGraphQlUrls в init:

POBP_RUM.init({
  // ...
  allowedGraphQlUrls: [
    {
      match: 'https://api.example.com/graphql',
      trackPayload: true,        // → resource.graphql.payload
      trackResponseErrors: true, // → resource.graphql.error_count, resource.graphql.errors
    },
  ],
})

Атрибуты действий (Action)

Данные о действиях пользователей (клики и пользовательские действия).

Таймеры и счётчики действий

Свойства действий

В сериализованном событии поля target.selector, target.width, target.height, position.x, position.y, а также способ вычисления имени (name_source) и селектор по composed path (composed_path_selector) находятся внутри _dd.action.

Автоматический сбор кликов управляется параметром trackUserInteractions в init. Пользовательские действия (action.type = custom) добавляются через API:

POBP_RUM.addAction('checkout_completed', { cart_value: 42 }) // доп. данные → context.*

Атрибуты Long Tasks

Длинные задачи — задачи, которые блокируют основной поток UI на продолжительный период. Long Animation Frames (LoAF) собираются как long tasks.

Атрибуты ошибок (Error)

Ошибки из источников source (необработанные JS-исключения), network, console и report (ReportingObserver) собираются автоматически. Пользовательские ошибки (error.source = custom) добавляются через API:

POBP_RUM.addError(new Error('Что-то пошло не так'), { context: 'checkout' }) // доп. данные → context.*

Сигналы фрустрации

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

Типы сигналов фрустрации:

• Dead click — пользователь нажимает на статичный элемент, который не производит никаких действий на странице
• Rage click — пользователь нажимает на элемент более трёх раз за односекундное скользящее окно
• Error click — пользователь нажимает на элемент непосредственно перед возникновением ошибки JavaScript

UTM-параметры

Параметры маркетинговых кампаний разбираются из строки запроса URL (вычисляется на сервере).

Устройство

device.type, device.brand, device.model, device.name определяются на сервере по заголовку User-Agent. device.locale, device.locales, device.time_zone отправляются Browser SDK напрямую.

Операционная система

Определяется на сервере по заголовку User-Agent.

Браузер (User Agent)

Определяется на сервере по заголовку User-Agent, отправляемому клиентом.

Геолокация

Геолокация определяется на стороне сервера на основе IP-адреса клиента.

Дисплей

Мобильные приложения (Android / iOS)

Мобильные агенты (Android, iOS и кросс-платформенные SDK — Flutter, React Native, Kotlin Multiplatform и др.) используют тот же формат событий RUM, что и браузер: общие атрибуты (сессия, просмотр, ресурс, действие, ошибка, пользователь, флаги функциональности) собираются точно так же.

Ниже описаны атрибуты и события, специфичные для мобильных платформ.

Источник события

Устройство и ОС (мобильные)

В отличие от браузера, мобильные SDK отправляют сведения об устройстве и ОС напрямую (не вычисляются на сервере), а также добавляют аппаратные характеристики.

Доступность (Accessibility)

Системные настройки доступности устройства на момент просмотра (поле view.accessibility.*).

Сетевое подключение (мобильное)

В дополнение к общим полям Connectivity мобильные SDK сообщают данные сотовой сети.

Мобильные метрики производительности View

Специфичные для мобильных приложений атрибуты потребления ресурсов устройства и качества рендеринга. Замороженным кадром считается кадр, рендеринг которого занимает аномально долго и приводит к видимому «зависанию» интерфейса (порог зависит от платформы).

CPU и память:

Рендеринг и кадры:

Видимость и навигация:

Мобильные действия (Action)

Ошибки и сбои (Error / Crash)

В дополнение к общим атрибутам ошибок мобильные агенты собирают данные о сбоях приложения.

Счётчики сбоев также агрегируются на уровне просмотра и действия: view.crash.count и action.crash.count.

Vital-события

Vital-события — отдельный тип событий (type: vital), собираемый мобильными SDK для измерения длительных операций и запуска приложения.

Общие свойства Vital:

Vital типа Duration (vital.type: duration):

Vital запуска приложения (vital.type: app_launch):

Vital шага операции (vital.type: operation_step):