Как настроить отслеживание ошибок — и узнавать о поломках раньше пользователей
Неприятная правда: пользователи не сообщают о багах. Они закрывают вкладку и не возвращаются. Ты об этом никогда не узнаешь — просто цифры будут чуть хуже, чем могли бы.
И вот в чём подстава именно у веб-приложений. Ошибка случилась в браузере пользователя — значит, и сообщение о ней осталось там же, в его консоли, куда тебе не заглянуть. Твой сервер про эту поломку вообще не в курсе.
Чинится это за один вечер. Ставим сборщик ошибок — сервис, который ловит падения у всех пользователей и присылает тебе отчёт со строкой кода.
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 коротких урока на телефоне.





