Сессии и пользователи фронтенда
Ошибка в браузере редко объясняет себя сама: важно, что человек делал перед ней, сколько посетителей она задела и стал ли релиз хуже предыдущего. Для этого у фронтенда в NablOps есть сессии: доля сессий без сбоев на вкладке «Обзор», хронология каждой сессии и поиск по пользователю — когда клиент пишет в поддержку «у меня не работает».
Сессии собирает тот же пакет @nablops/react, что и ошибки фронтенда; отдельно включать ничего не нужно. Для поиска по пользователю нужен @nablops/react 0.3.0 и новее.
Что такое сессия и сессия со сбоем
Сессия — одно посещение приложения во вкладке браузера. Новая сессия начинается после 30 минут бездействия. У каждой сессии один из статусов:
| Статус | Что значит |
|---|---|
| «без ошибок» | всё прошло гладко |
| «с ошибками» | были ошибки, которые приложение обработало само (например, captureException в catch) |
| «сбой» | у посетителя случилась необработанная ошибка: исключение, отклонённый промис, падение компонента |
Доля сессий без сбоев (crash-free) — процент сессий без статуса «сбой». Это главный показатель стабильности фронтенда: число ошибок зависит от посещаемости, а доля сессий показывает, сколько людей на самом деле наткнулись на проблему.
Вкладка «Обзор»
На вкладке «Обзор» — сводка за сутки, 7 или 30 дней:
- «Без сбоев» — доля сессий без сбоев и как она изменилась по сравнению с прошлым периодом («накануне», «неделей раньше», «месяцем раньше»).
- «Сессии» — сколько было сессий и сравнение с прошлым периодом.
- «Пользователи» — сколько разных пользователей передало приложение, и отдельно — сессии без входа.
- «Со сбоем» — сколько сессий закончились сбоем и сколько были с обработанными ошибками; клик открывает эти сессии.
- «Сессии по времени» — график, на котором красным отмечены сессии со сбоем.
- «Релизы — доля сессий без сбоев» — число сессий и доля без сбоев в каждом релизе. Так сразу видно, стала ли новая выкладка хуже предыдущей.
Доля сессий без сбоев за сутки видна и на карточке фронтенда на странице проекта.
Вкладка «Сессии» и страница сессии
На вкладке «Сессии» — список сессий за выбранный период с фильтром «Все сессии», «Со сбоем», «С ошибками». В строке — длительность, число страниц и ошибок.
Клик открывает страницу сессии. Наверху — начало, длительность, число страниц и ошибок, браузер и система, устройство, релиз и страница входа. Ниже — «Хронология», по времени от начала сессии:
- переходы между страницами — шаблонами маршрутов (
/projects/:id), если роутер подключён черезnabl.wrapCreateBrowserRouter; - клики по кнопкам и ссылкам — текст кнопки и селектор;
- консоль — сообщения
console.error; - запросы к API — метод, адрес, статус и ссылка на трассу бэкенда, подробнее — в статье запросы из браузера;
- ошибки — со ссылкой на страницу ошибки.
Клики и сообщения консоли пакет прикладывает к ошибкам, поэтому у сессии без ошибок в хронологии видны только переходы и запросы. Значения полей ввода не собираются никогда — ни паролей, ни адресов, ни текста сообщений. Текст элемента внутри data-nabl-private тоже не берётся.
Сессии хранятся 30 дней.
Как передать пользователя: nabl.setUser
Чтобы видеть, кого задела ошибка, и находить сессии клиента, передайте пакету внутренний id пользователя после входа:
import * as nabl from '@nablops/react';
// после входа
nabl.setUser({ id: user.id });
// при выходе
nabl.setUser(null);С @nablops/react 0.4.0 (NablOps 0.31.0) в NablOps уходит только id — даже если передать email и имя, они не отправляются. Этого хватает и для поиска, и для подсчёта затронутых пользователей. Используйте внутренний id клиента из вашей базы, а не email или телефон.
Если пользователи не передаются, на «Обзоре» появится подсказка вызвать nabl.setUser({ id }).
Поиск клиента по id
Клиент пишет в поддержку, что у него не работает оплата. Откройте фронтенд → «Сессии» и введите в поиск его id — то значение, которое приложение передаёт в nabl.setUser. NablOps покажет все его сессии и ошибки за 30 дней: какие ошибки у него случались и сколько раз, а из сессии — что именно он делал перед сбоем.
Если по id ничего не нашлось, проверьте, что приложение действительно вызывает setUser после входа и передаёт то же значение, что вы ищете.
Кого задела ошибка
На странице ошибки фронтенда, в блоке «Где случается», — число сессий за 30 дней, браузеры, системы, страницы и пользователи: у кого ошибка случалась и сколько раз. От каждого пользователя можно перейти ко всем его сессиям или к последней сессии с этой ошибкой.
Ошибка у вошедшего пользователя всегда приходит уведомлением — даже если лимит в 5 уведомлений о новых ошибках за час уже исчерпан. Подробнее о лимите — в статье ошибки фронтенда на React.
Уведомление: доля сессий без сбоев ниже порога
Правило «Сессий без сбоев меньше 98 % за час» сообщает, когда фронтенд стал падать чаще — например, после неудачной выкладки посетители начали натыкаться на ошибку:
- в новых проектах оно включается вместе с первым фронтендом, уровень — «ошибка»;
- каждый фронтенд проекта проверяется отдельно;
- пока за окно меньше 20 сессий, правило молчит: ночью одна упавшая сессия из двух не поднимет тревогу.
Порог и окно (от 15 минут) меняются в «Правилах» проекта — см. правила уведомлений. Для фронтенда с небольшой посещаемостью разумно взять окно побольше, для нагруженного — порог повыше. Если фронтенд был создан до появления правила, создайте его вручную или попросите ИИ-ассистента.
Приватность и 152-ФЗ
Сессии устроены так, чтобы не собирать лишнего:
- из данных пользователя хранится только внутренний
id, который передаёт ваше приложение; email и имя пакет не отправляет; - значения полей ввода не собираются, у кликов — только селектор и текст кнопки;
- почта, телефоны, номера карт и токены в текстах ошибок и адресах маскируются при приёме, токены в путях заменяются на
:token; - переходы хранятся шаблонами маршрутов или путём страницы, без query-параметров;
- IP-адрес посетителя используется только для лимитов приёма и не сохраняется.
Анонимный id посетителя в localStorage по умолчанию не пишется. Если на сайте есть баннер согласия на cookie, разрешите его после согласия: nabl.setConsent({ storage: true }). Без этого посетители без входа видны только как отдельные сессии — связать два визита одного человека нельзя.
Сессии через ИИ-ассистента
ИИ-ассистент видит то же самое: долю сессий без сбоев по релизам, сессии с фильтром по статусу, релизу и пользователю, хронологию сессии и затронутых пользователей ошибки. Можно спросить: «что случилось у клиента 1042 вчера вечером» — ассистент найдёт его сессии, ошибку и, если она связана с упавшим запросом, трассу на бэкенде.
Что дальше
- Запросы из браузера и трасса бэкенда — запросы в хронологии сессии.
- Source maps и релизы — новые ошибки и выкладки по релизам.
- Правила уведомлений — порог доли сессий без сбоев.
- Ошибки фронтенда на React — подключение пакета.
Первый сервер или стек подключается за пару минут. Бесплатно в раннем доступе.
Нашли неточность или не хватает ответа? Напишите в поддержку