re:re:actable
Урок 063 минуты чтения

Как обеспечить наблюдаемость: логи, метрики и feature flags

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

Наблюдаемость (observability) фронтенда — возможность узнать, что происходит у реальных пользователей: какие ошибки возникают (error tracking: Sentry), насколько быстро работает приложение (RUM: Core Web Vitals с реальных устройств), как используются функции (продуктовая аналитика) и как связаны действия пользователя с запросами к бэкенду (трассировка). Вместе с feature flags и постепенной выкаткой это позволяет безопасно выпускать изменения и быстро находить проблемы.

Вопрос

Как обеспечить наблюдаемость фронтенд-приложения? Что собирать, как связать ошибки фронтенда с бэкендом и зачем нужны feature flags?

Что собирать

ТипПримерыИнструменты
Ошибкиисключения JS, отклоненные промисы, ошибки Error Boundary, сбои загрузки чанковSentry, Bugsnag
Производительность (RUM)LCP, INP, CLS, TTFB, долгие задачиweb-vitals, Sentry Performance, Datadog RUM
Сетьошибки и время ответов APIинтерцептор API-клиента
Продуктклики, конверсии, воронкиAmplitude, Mixpanel, PostHog
Сессиизапись сессии для воспроизведения багаSentry Replay, LogRocket

Ошибки

import * as Sentry from "@sentry/react";
 
Sentry.init({
  dsn: import.meta.env.VITE_SENTRY_DSN,
  release: import.meta.env.VITE_RELEASE,     // связать с версией и source maps
  environment: import.meta.env.MODE,
  tracesSampleRate: 0.1,                     // трассировать 10% сессий
});
 
window.addEventListener("unhandledrejection", (e) => Sentry.captureException(e.reason));
  • source maps загружаются в Sentry при сборке, а не раздаются публично;
  • контекст: id пользователя (без персональных данных), маршрут, версия, браузер;
  • группировка и алерты на рост ошибок после релиза.

RUM-метрики

import { onCLS, onINP, onLCP } from "web-vitals";
 
function send(metric: { name: string; value: number; id: string }) {
  navigator.sendBeacon("/api/rum", JSON.stringify({ ...metric, page: location.pathname }));
}
 
onLCP(send);
onINP(send);
onCLS(send);

Смотрят на перцентили (p75), а не на среднее: важен опыт медленных пользователей.

Связь с бэкендом

  • traceparent (W3C Trace Context) в заголовках запросов — один trace от клика до базы данных;
  • requestId в ответах API показывают в сообщении об ошибке («Код ошибки: a1b2c3») — поддержка найдет запрос в логах.

Feature flags и выкатка

const showNewCheckout = useFlag("new-checkout");     // LaunchDarkly, Unleash, GrowthBook
return showNewCheckout ? <NewCheckout /> : <OldCheckout />;
  • постепенная выкатка: 1% → 10% → 50% → 100% с наблюдением за ошибками и метриками;
  • kill switch: выключить сломанную функцию без деплоя;
  • A/B-тесты: сравнить варианты по продуктовым метрикам;
  • флаги удаляют после полной выкатки, иначе код обрастает ветками.

Что важно помнить

  • Без мониторинга вы узнаете о проблемах от пользователей — назовите на интервью хотя бы ошибки и RUM.
  • Ограничивайте объем: сэмплирование трассировок и сессий, батчинг событий, sendBeacon при уходе со страницы.
  • Персональные данные не отправляются в логи и записи сессий — маскирование полей ввода.
  • Ошибки загрузки чанков после деплоя (ChunkLoadError) — частая проблема: перезагрузка страницы или хранение старых версий файлов.
  • Связанные темы: CI/CD, логирование ошибок в React.

Мини-шпаргалка

Ошибки — Sentry + source maps + release. Производительность — RUM через web-vitals, смотреть p75. Сеть — время и ошибки API. Связь с бэкендом — traceparent, requestId. Feature flags — постепенная выкатка, kill switch, A/B. Сэмплирование и без персональных данных.

Документация

Sentry: React, GoogleChrome/web-vitals, W3C: Trace Context, Martin Fowler: Feature Toggles.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам