Развернуть Sentry на VPS стоит тем, кто хочет узнавать о сбоях в приложении раньше пользователей. Если у клиента не открывается корзина или падает мобильное приложение, он редко пишет в поддержку. Чаще он просто закрывает вкладку.
Sentry собирает такие сбои в одном окне и показывает, в каком месте сломался код. С сентября 2024 года облачная версия сервиса закрыта для пользователей из России, поэтому многие команды переносят Sentry на собственный сервер.
Разберём, как устроен self-hosted Sentry, какой сервер ему нужен, как пройти установку по шагам и какие ошибки чаще всего мешают запуску. Материал пригодится разработчикам, руководителям небольших команд и владельцам онлайн-проектов.
Что такое Sentry и чем он полезнее обычных логов?
Sentry собирает ошибки из приложений и превращает их в понятные карточки. В карточке видно, в какой строке кода произошёл сбой, у какого пользователя и в какой версии приложения. Если ошибка повторилась тысячу раз, Sentry объединит её в одну запись со счётчиком.
Перед установкой полезно разобраться в нескольких терминах:
-
Событие. Один случай ошибки, который приложение отправило в Sentry.
-
Issue. Группа одинаковых событий. С ней работает команда: назначает ответственного, отмечает исправление.
-
SDK. Небольшая библиотека внутри приложения. Она перехватывает ошибки и пересылает их в Sentry.
-
DSN. Адрес проекта, по которому SDK отправляет события.
-
Релиз. Версия приложения. По ней видно, после какого обновления появилась ошибка.
Обычные логи записывают всё подряд, и чтобы найти в них причину сбоя, нужно заранее знать, что искать. Sentry работает от обратного: сам сообщает о новой ошибке и сразу прикладывает контекст.
Зачем ставить Sentry на свой сервер, если есть облачная версия?
У Sentry есть облачный сервис sentry.io и версия для самостоятельной установки, её называют self-hosted. Для команд из России выбор во многом сделан заранее. С 10 сентября 2024 года компания закрыла доступ к облаку всем, кто находится в РФ, расторгла платные аккаунты российских клиентов и перестала принимать от них оплату.
Self-hosted версия устроена иначе: исходный код опубликован, а сервис работает целиком на вашем сервере. Это даёт ещё несколько преимуществ:
-
Нет платы за события. Разработчики описывают self-hosted как аналог тарифа Business без программных ограничений.
-
Данные остаются у вас. В отчётах об ошибках бывают IP-адреса и идентификаторы устройств, а это может относиться к персональным данным. Сама установка на свой сервер соответствие 152-ФЗ не обеспечивает, зато вы точно знаете, где лежат данные и у кого к ним доступ.
-
Понятная лицензия. Sentry распространяется по Functional Source License: пользоваться им можно в компании любого размера, продавать как сервис запрещено. Через два года после выхода каждая версия переходит на лицензию Apache 2.0.
Из чего состоит self-hosted Sentry и почему ему нужно так много ресурсов?
Снаружи Sentry выглядит как сайт с панелью управления. Внутри работает целый набор сервисов в Docker-контейнерах. Путь одной ошибки выглядит так:
-
Приложение с SDK ловит сбой и отправляет событие по адресу DSN.
-
Сервис Relay принимает событие и проверяет, к какому проекту оно относится.
-
Событие попадает в очередь Kafka, чтобы ничего не потерялось при наплыве ошибок.
-
Обработчики группируют похожие события, а Symbolicator восстанавливает читаемый стек вызовов.
-
События сохраняются в ClickHouse, пользователи и настройки проектов в PostgreSQL. Snuba отвечает за быстрый поиск.
-
Веб-интерфейс показывает новую issue, команда получает уведомление.
Ещё в стеке работают Redis и фоновые воркеры. Все сервисы запускаются на одной машине, отсюда высокие требования к памяти и особенно к диску.
Чтобы снизить нагрузку, у Sentry есть два профиля установки:
-
feature-complete. Полный набор функций, включён по умолчанию.
-
errors-only. Только сбор ошибок, группировка, поиск и оповещения, без мониторинга производительности и других дополнительных модулей.
Какие плюсы и ограничения у собственного Sentry?
Плюсы:
-
нет лимитов на события и пользователей;
-
почти все функции облачной версии доступны бесплатно;
-
данные хранятся на вашем сервере;
-
работа возможна в сети без доступа в интернет;
-
подходят те же SDK, что и для облака.
Ограничения:
-
Ресурсы. Минимальная конфигурация заметно мощнее типичного сервера под сайт.
-
Обслуживание. Обновления, резервные копии и наблюдение за самим Sentry ложатся на вашу команду.
-
Поддержка. Официальная помощь ограничена базовой установкой, остальное решается через сообщество в Discord.
-
Функции. Нет AI-помощника Seer, защиты от всплесков событий и биллинга. Ограничена расшифровка системных символов iOS и Android, поддержка PlayStation недоступна без разрешения Sony.
-
Обновления. Перескочить сразу через несколько версий нельзя, подробности ниже.
Где собственный Sentry приносит больше всего пользы?
Self-hosted Sentry окупается там, где ошибок много, а данные хочется держать под контролем. Разберём четыре типовые ситуации.
Как вернуть мониторинг команде, потерявшей доступ к sentry.io?
После блокировки облака команда осталась без отчётов об ошибках. Переписывать приложение не придётся: SDK остаётся прежним, меняется только DSN. Достаточно поднять Sentry на VPS, создать проекты и заменить адрес в настройках. Если доступа к старому аккаунту нет, история ошибок начнётся с чистого листа.
Как веб-студии следить за ошибками сразу нескольких клиентов?
Агентство ведёт десяток интернет-магазинов, и у каждого свои сбои: корзина, оплата, форма заказа. Облачные тарифы при таком объёме быстро дорожают. Один экземпляр Sentry закрывает задачу: под каждого клиента создаётся отдельный проект с доступом только для нужных разработчиков.
Как ловить ошибки в корпоративных системах на 1С?
Sentry применяют и за пределами веб-разработки. В Magnit Tech с его помощью разбирают ошибки 1С: настраивают оповещения по журналу регистрации и следят за производительностью базы. Свой сервер здесь удобен, потому что данные учётных систем остаются внутри компании.
Как собирать ошибки в сети без доступа в интернет?
На закрытых предприятиях серверы часто изолированы от внешней сети. Sentry ставят через прокси или переносят готовые образы с другой машины, а параметр SENTRY_AIR_GAP отключает все внешние сетевые обращения. Ошибки внутренних сервисов не покидают периметр.
Когда вместо Sentry лучше поставить лёгкий трекер ошибок?
Если сервер скромный и нужен только сбор ошибок, стоит посмотреть на более лёгкие системы:
-
GlitchTip. Открытый трекер с лицензией MIT. Рекомендуемый объём памяти 512 МБ, минимально рабочий 256 МБ.
-
Bugsink. Работает в одном контейнере и по умолчанию хранит данные в SQLite. Производитель тестировал его на сервере с 2 vCPU и 4 ГБ RAM.
-
Hawk. Российский сервис с серверами в России и оплатой по счёту для юрлиц.
Все три принимают события от SDK Sentry, поэтому переключиться можно сменой DSN. Если нужны дашборды, мониторинг производительности и полный набор интеграций, выбирайте Sentry и закладывайте под него подходящий сервер.
Какой VPS выбрать, чтобы развернуть Sentry без сбоев?
Официальные требования к серверу для self-hosted Sentry:
-
4 ядра процессора;
-
16 ГБ оперативной памяти и 16 ГБ swap;
-
20 ГБ свободного места на диске;
-
Docker 19.03.6 и Docker Compose 2.32.2 или новее.
Разработчики рекомендуют 32 ГБ RAM, но допускают 16 ГБ, если swap лежит на быстром диске. При выборе учтите ещё несколько моментов:
-
Скорость диска. SSD или NVMe с высоким IOPS заметно ускоряют Sentry. Если iowait стабильно выше 10% процессорного времени, диск не справляется.
-
Операционная система. Лучше всего подходят Ubuntu и Debian. С CentOS, Rocky Linux и AlmaLinux бывают проблемы, Alpine Linux не поддерживается.
-
Виртуализация. Сервер должен полноценно поддерживать Docker. На Хабре описан случай, когда Sentry не запускался стабильно из-за особенностей виртуализации у хостинга.
-
Запас диска. По умолчанию события хранятся 90 дней, и чем больше ошибок, тем больше места нужно.
Такую конфигурацию удобно собрать в облаке. В VPS от Serverspace можно выбрать локацию в Москве или Санкт-Петербурге, чтобы данные оставались в России, и задать нужные vCPU, RAM и объём диска. Когда нагрузка вырастет, ресурсы добавляются без переустановки системы, достаточно перезагрузки.
| Параметр | Минимум | Рекомендация | Зачем это нужно |
|---|---|---|---|
| Процессор | 4 ядра | Больше ядер при росте числа событий | Обработка очереди событий и фоновых задач |
| Оперативная память | 16 ГБ | 32 ГБ | Базы данных, Kafka и обработчики работают одновременно |
| Swap | 16 ГБ | На быстром SSD или NVMe | Страховка от нехватки памяти при пиковой нагрузке |
| Свободное место | 20 ГБ | С запасом под срок хранения событий | События, вложения и базы данных растут вместе с трафиком |
| Тип диска | SSD | NVMe с высоким IOPS | При iowait выше 10% диск перестаёт справляться |
| Операционная система | Ubuntu или Debian | Актуальная LTS-версия Ubuntu | С RHEL-семейством бывают сбои, Alpine не поддерживается |
| Docker и Compose | 19.03.6 и 2.32.2 | Последние стабильные версии | Установщик проверяет версии и останавливается на старых |
Как установить Sentry на VPS шаг за шагом?
Ниже базовый порядок установки на чистый сервер с Ubuntu. Команды выполняются от пользователя с правами sudo.
Как подготовить сервер к установке?
В Serverspace Linux-сервер с Ubuntu создаётся из шаблона примерно за 40 секунд. После входа по SSH обновите систему и добавьте swap:
sudo fallocate -l 16G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile && sudo swapon /swapfile
Чтобы swap подключался после перезагрузки, добавьте строку /swapfile none swap sw 0 0 в файл /etc/fstab. В фаерволе оставьте открытыми порты 22, 80 и 443, а у регистратора домена создайте A-запись для поддомена, например sentry.example.ru.
Как поставить Docker и проверить версии?
Docker ставьте из официального репозитория по инструкции на сайте Docker: в стандартных репозиториях Ubuntu Compose может оказаться слишком старым. Затем проверьте версии:
docker compose version
Если Compose старше 2.32.2, установщик Sentry остановится с ошибкой.
В мае 2024 года Docker Hub закрыл доступ для пользователей из России. Если образы не скачиваются, настройте в Docker зеркало реестра.
Как скачать нужную версию Sentry и запустить установщик?
Берите последний опубликованный релиз: в ветке master лежит код в разработке. Команды ниже сами определят номер свежей версии:
VERSION=${VERSION##*/}
git clone https://github.com/getsentry/self-hosted.git
cd self-hosted
git checkout ${VERSION}
Перед установкой проверьте в файле .env две настройки:
-
COMPOSE_PROFILES=errors-only, если нужен только мониторинг ошибок. Для полного набора оставьте feature-complete.
-
SENTRY_BIND=127.0.0.1:9000. Docker публикует порты в обход стандартного фаервола, и без этой строки порт 9000 окажется доступен из интернета.
Затем запустите ./install.sh. Скрипт скачает образы, подготовит базы данных и предложит создать администратора. Он также спросит, отправлять ли разработчикам данные о сбоях установки. Ответ можно задать флагом --report-self-hosted-issues или --no-report-self-hosted-issues.
Как запустить Sentry и выполнить первый вход?
После установки запустите сервисы командой docker compose up --wait и проверьте их через docker compose ps. У всех контейнеров должен быть статус Up или healthy.
Пока домен не настроен, Sentry доступен только с самого сервера. Для первого входа пробросьте порт командой ssh -L 9000:127.0.0.1:9000 user@IP-сервера и откройте http://127.0.0.1:9000. Мастер настройки попросит указать адрес сервиса и решить, разрешать ли самостоятельную регистрацию. Её лучше выключить и приглашать коллег вручную.
Как открыть Sentry по домену с HTTPS?
Перед Sentry обычно ставят nginx или Caddy. Прокси принимает запросы на 443-й порт и передаёт их на 127.0.0.1:9000 вместе с исходным протоколом и IP-адресом клиента. Бесплатный сертификат выпускается через Let's Encrypt.
Затем поправьте два файла в папке sentry:
-
в config.yml укажите адрес в параметре system.url-prefix, например https://sentry.example.ru;
-
в sentry.conf.py включите параметры блока SSL/TLS для работы за прокси.
Без этого при входе и настройке интеграций появятся ошибки CSRF. После правки выполните docker compose restart. Работоспособность удобно проверять по адресу /_health/: он отвечает кодом 200 или кодом 500 со списком проблем.
Как настроить почту для приглашений и уведомлений?
Без почты Sentry не отправит приглашения и письма о новых ошибках. Встроенный SMTP-сервер есть, но письма с нового IP-адреса крупные почтовые сервисы часто отклоняют. Надёжнее подключить внешний сервис через параметры mail.* в файле config.yml.
Порт 25 часто закрыт у хостинг-провайдеров, а Gmail на нём не принимает отправку. Используйте порт 587 с TLS и проверьте настройку тестовым письмом из админки Sentry.
Как подключить приложение и убедиться, что ошибки доходят?
Создайте проект и выберите платформу: JavaScript, Python, PHP, Go или другую. Sentry покажет инструкцию по установке SDK и DSN. Для JavaScript подключение выглядит так:
Вызовите тестовую ошибку. Если она появилась в списке issues, связка работает. Дальше передавайте в SDK номер релиза, чтобы видеть, после какого обновления начались сбои.
Как поддерживать Sentry в рабочем состоянии после запуска?
Как обновлять Sentry и не повредить данные?
Новые версии выходят каждый месяц, основной релиз приходится на 15-е число. Номер строится по календарю: 26.7.0 означает июль 2026 года.
Перепрыгивать через обязательные промежуточные версии (hard stops) нельзя: в них выполняются миграции баз данных. На октябрь 2026 года среди них 24.8.0, 25.5.1, 26.5.0 и 26.7.0. Документация также советует пропускать 25.9.0, 25.12.0 и версии с 26.3.0 по 26.4.0. Перед каждым обновлением сверяйте список с официальной документацией. Само обновление выглядит так:
git checkout 26.7.0
./install.sh
docker compose up --wait
Перед обновлением сделайте снимок сервера. Чаще всего обновление ломается у тех, кто год не трогал Sentry и прыгнул сразу через несколько обязательных версий.
Что входит в резервную копию?
Встроенный экспорт сохраняет только пользователей, организации, проекты и настройки, без самих событий. Полное копирование Docker-томов возможно, но официально не поддерживается. Надёжная схема: регулярный экспорт настроек, снимки сервера перед обновлениями и пробное восстановление на отдельной машине.
Как не дать событиям занять весь диск?
Срок хранения задаёт переменная SENTRY_EVENT_RETENTION_DAYS в файле .env, по умолчанию 90 дней. Если места мало, уменьшите её, например до 30. Следите за диском командой df -h: при полном заполнении Sentry перестаёт принимать события. Большие объёмы файлов можно вынести во внешнее S3-хранилище.
Какие ошибки чаще всего мешают Sentry работать?
Большинство проблем с self-hosted Sentry повторяются от установки к установке. Мы собрали типичные симптомы, их причины и решения в одну таблицу.
| Симптом | Причина | Решение |
|---|---|---|
| Контейнеры постоянно перезапускаются, установка не завершается | Не хватает памяти, система принудительно завершает процессы | Довести RAM и swap до 16 ГБ, проверить журнал командой dmesg -T |
| Интерфейс тормозит, события приходят с задержкой | Медленный диск, iowait выше 10% | Перейти на NVMe, проверить нагрузку через top или iostat |
| install.sh останавливается с сообщением FAIL: Expected minimum | Устаревший Docker Compose | Установить Docker из официального репозитория |
| Образы Docker не скачиваются | Docker Hub недоступен с российских IP-адресов | Настроить в Docker зеркало реестра |
| Ошибка CSRF после подключения HTTPS | Не обновлены system.url-prefix и настройки SSL | Исправить config.yml и sentry.conf.py, перезапустить сервисы |
| Не приходят приглашения и уведомления | Почта не настроена или закрыт порт | Подключить внешний SMTP на порту 587, отправить тестовое письмо |
| Обновление прерывается из-за пропущенного hard stop | Пропущена обязательная промежуточная версия | Восстановиться из снимка и пройти обязательные версии по очереди |
| Новые события перестали появляться | Диск заполнен полностью | Сократить срок хранения событий, расширить диск |
| Часть ошибок из браузера не доходит | Блокировщики рекламы режут запросы к Sentry | Включить в SDK опцию tunnel и отправлять события через свой домен |
| Sentry упал, и никто этого не заметил | Нет внешнего мониторинга | Проверять адрес /_health/ с другого сервера, например через Uptime Kuma |
С чего начать, чтобы Sentry заработал с первой попытки?
Self-hosted Sentry даёт полный контроль над мониторингом ошибок и снимает вопрос с недоступностью облака. Взамен он требует мощного сервера и регулярного обслуживания. Развернуть Sentry на VPS можно без глубокой экспертизы в DevOps, если соблюдать порядок действий:
-
Решите, нужен ли полный Sentry, профиль errors-only или лёгкий трекер.
-
Подберите сервер не слабее официального минимума и с быстрым диском.
-
Установите последний релиз, закройте порт 9000 и подключите домен с HTTPS.
-
Настройте почту и отправьте тестовую ошибку.
-
Запланируйте ежемесячные обновления и резервные копии.
Сервер под Sentry удобно подобрать среди виртуальных серверов Serverspace: начните с официального минимума и расширяйте конфигурацию, когда вырастет число проектов и событий.