Гайды

Как настроить отслеживание ошибок — и узнавать о поломках раньше пользователей

Иллюстрация: сигнальная лампа над окном приложения, отчёт летит к разработчику

Неприятная правда: пользователи не сообщают о багах. Они закрывают вкладку и не возвращаются. Ты об этом никогда не узнаешь — просто цифры будут чуть хуже, чем могли бы.

И вот в чём подстава именно у веб-приложений. Ошибка случилась в браузере пользователя — значит, и сообщение о ней осталось там же, в его консоли, куда тебе не заглянуть. Твой сервер про эту поломку вообще не в курсе.

Чинится это за один вечер. Ставим сборщик ошибок — сервис, который ловит падения у всех пользователей и присылает тебе отчёт со строкой кода.

1. Заведи проект в Sentry

Иди на sentry.io, зарегистрируйся, создай организацию и проект. Бесплатного тарифа хватает пет-проекту с запасом: есть месячный лимит событий, платить на старте не нужно.

При создании проекта выбери свою платформу — Next.js, React, Node.js, Python. От выбора зависит инструкция, которую тебе покажут.

Альтернативы, если Sentry не подошёл: Bugsnag, Rollbar или GlitchTip (открытый, можно поставить на свой сервер). Дальше показываю на Sentry — он самый распространённый, а принцип везде один.

2. Поставь SDK одной командой

Для Next.js есть мастер, который делает всю рутину сам:

npx @sentry/wizard@latest -i nextjs

Он откроет браузер для входа, спросит, какие функции включить (оставь Error Monitoring, остальное по вкусу), и сам пропишет конфиги, обновит next.config, добавит обработчик global-error.tsx и создаст тестовую страницу.

Для других стеков команда своя: -i react, -i sveltekit, -i nuxt. Если фреймворка нет в списке — ставишь пакет вручную и вызываешь Sentry.init({ dsn: ... }) в точке запуска приложения. Это десять строк.

Проверь, что мастер добавил, через git status — полезно понимать, что попало в проект.

3. Отправь тестовую ошибку

Не верь установке на слово. Мастер создаёт страницу /sentry-example-page с кнопкой, которая ломает приложение специально. Запусти проект, открой её, нажми кнопку.

Если мастера не было — брось ошибку руками:

throw new Error("Sentry test error");

Через несколько секунд событие должно появиться в разделе Issues. Не появилось — почти всегда дело в DSN: он либо не прописан, либо не подхватился на нужной стороне (клиент/сервер).

Важная деталь: ошибки, вызванные из консоли браузера, Sentry намеренно не ловит. Проверяй кнопкой или кодом, а не набором throw в devtools.

4. Разложи ключи по переменным окружения

У Sentry два разных значения, и путать их опасно.

  • DSN — публичный адрес, куда шлются отчёты. Он попадает в клиентский код, это нормально и задумано так.
  • Auth token — секретный, нужен только сборке для загрузки source maps. Ему место в .env.local и в переменных хостинга, и его нельзя коммитить.

Если ещё не разбирался, как это устроено — вот разбор про переменные окружения и про безопасное хранение ключей.

5. Включи source maps, иначе трейс бесполезен

В продакшене твой код минифицирован: имена переменных превращаются в a, b, c, всё склеено в одну строку. Ошибка в таком виде читается как «сломалось в t.js:1:48219». Толку ноль.

Source maps — карта соответствия между собранным кодом и исходником. С ней Sentry покажет твой файл, твою строку и твой код вокруг неё. Мастер настраивает загрузку карт сам, тебе нужно лишь добавить SENTRY_AUTH_TOKEN в переменные окружения на хостинге, иначе загрузка на сборке молча не сработает.

6. Настрой алерты, чтобы не ходить в дашборд

Самый частый провал: ошибки собираются, а смотреть на них никто не ходит.

В настройках проекта → Alerts включи уведомление на новую проблему. Минимум — на почту. Лучше — в Slack или телеграм-канал, куда ты и так смотришь каждый день.

Хорошее правило для старта: алерт на каждую новую ошибку (не на каждое повторение). Так ты узнаёшь о поломке в момент её появления и не тонешь в шуме от одного и того же бага.

7. Отсеки шум

Через день ты увидишь события, к которым не имеешь отношения: расширения браузера, скрипты аналитики, обрывы сети у пользователей в метро.

Их фильтруют в Sentry.init — параметром ignoreErrors со списком типовых сообщений и denyUrls для чужих скриптов. Для нагруженного проекта добавляют ещё tracesSampleRate — долю трассировок производительности, которую реально отправлять.

Что получится

Пользователь ловит баг — а через минуту тебе прилетает письмо: текст ошибки, стек с твоей строкой кода, браузер и ОС, и цепочка действий, которые к этому привели. Часто этого хватает, чтобы понять причину, ни о чём не спрашивая пользователя.

Дальше остаётся только уметь читать сам отчёт — про это есть отдельный разбор, как читать сообщение об ошибке.

Это заменяет логи?

Нет, они про разное. Логи — сплошная лента событий: что происходило и в каком порядке. Сборщик ошибок — только падения, но сгруппированные, посчитанные и с контекстом. Логи ищешь, когда уже знаешь, куда смотреть; алерт об ошибке приходит сам.

Нужно ли это, если у меня десять пользователей?

Особенно нужно. При десяти пользователях каждая незамеченная поломка — это минус десять процентов аудитории. И настройка занимает пятнадцать минут ровно один раз.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →