Сессии и пользователи фронтенда

Ошибка в браузере редко объясняет себя сама: важно, что человек делал перед ней, сколько посетителей она задела и стал ли релиз хуже предыдущего. Для этого у фронтенда в 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 пользователя после входа:

ts
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 вчера вечером» — ассистент найдёт его сессии, ошибку и, если она связана с упавшим запросом, трассу на бэкенде.

Что дальше

Попробуйте NablOps

Первый сервер или стек подключается за пару минут. Бесплатно в раннем доступе.

Создать аккаунт

Нашли неточность или не хватает ответа? Напишите в поддержку