☰
28.10.2026

Как развернуть Sentry на VPS для мониторинга ошибок приложения

Развернуть Sentry на VPS стоит тем, кто хочет узнавать о сбоях в приложении раньше пользователей. Если у клиента не открывается корзина или падает мобильное приложение, он редко пишет в поддержку. Чаще он просто закрывает вкладку.

Sentry собирает такие сбои в одном окне и показывает, в каком месте сломался код. С сентября 2024 года облачная версия сервиса закрыта для пользователей из России, поэтому многие команды переносят Sentry на собственный сервер.

Разберём, как устроен self-hosted Sentry, какой сервер ему нужен, как пройти установку по шагам и какие ошибки чаще всего мешают запуску. Материал пригодится разработчикам, руководителям небольших команд и владельцам онлайн-проектов.

Что такое Sentry и чем он полезнее обычных логов?

Sentry собирает ошибки из приложений и превращает их в понятные карточки. В карточке видно, в какой строке кода произошёл сбой, у какого пользователя и в какой версии приложения. Если ошибка повторилась тысячу раз, Sentry объединит её в одну запись со счётчиком.

Перед установкой полезно разобраться в нескольких терминах:

Обычные логи записывают всё подряд, и чтобы найти в них причину сбоя, нужно заранее знать, что искать. Sentry работает от обратного: сам сообщает о новой ошибке и сразу прикладывает контекст.

Зачем ставить Sentry на свой сервер, если есть облачная версия?

У Sentry есть облачный сервис sentry.io и версия для самостоятельной установки, её называют self-hosted. Для команд из России выбор во многом сделан заранее. С 10 сентября 2024 года компания закрыла доступ к облаку всем, кто находится в РФ, расторгла платные аккаунты российских клиентов и перестала принимать от них оплату.

Self-hosted версия устроена иначе: исходный код опубликован, а сервис работает целиком на вашем сервере. Это даёт ещё несколько преимуществ:

Из чего состоит self-hosted Sentry и почему ему нужно так много ресурсов?

Снаружи Sentry выглядит как сайт с панелью управления. Внутри работает целый набор сервисов в Docker-контейнерах. Путь одной ошибки выглядит так:

  1. Приложение с SDK ловит сбой и отправляет событие по адресу DSN.

  2. Сервис Relay принимает событие и проверяет, к какому проекту оно относится.

  3. Событие попадает в очередь Kafka, чтобы ничего не потерялось при наплыве ошибок.

  4. Обработчики группируют похожие события, а Symbolicator восстанавливает читаемый стек вызовов.

  5. События сохраняются в ClickHouse, пользователи и настройки проектов в PostgreSQL. Snuba отвечает за быстрый поиск.

  6. Веб-интерфейс показывает новую issue, команда получает уведомление.

Ещё в стеке работают Redis и фоновые воркеры. Все сервисы запускаются на одной машине, отсюда высокие требования к памяти и особенно к диску.

Чтобы снизить нагрузку, у Sentry есть два профиля установки:

Какие плюсы и ограничения у собственного Sentry?

Плюсы:

Ограничения:

Где собственный Sentry приносит больше всего пользы?

Self-hosted Sentry окупается там, где ошибок много, а данные хочется держать под контролем. Разберём четыре типовые ситуации.

Как вернуть мониторинг команде, потерявшей доступ к sentry.io?

После блокировки облака команда осталась без отчётов об ошибках. Переписывать приложение не придётся: SDK остаётся прежним, меняется только DSN. Достаточно поднять Sentry на VPS, создать проекты и заменить адрес в настройках. Если доступа к старому аккаунту нет, история ошибок начнётся с чистого листа.

Как веб-студии следить за ошибками сразу нескольких клиентов?

Агентство ведёт десяток интернет-магазинов, и у каждого свои сбои: корзина, оплата, форма заказа. Облачные тарифы при таком объёме быстро дорожают. Один экземпляр Sentry закрывает задачу: под каждого клиента создаётся отдельный проект с доступом только для нужных разработчиков.

Как ловить ошибки в корпоративных системах на 1С?

Sentry применяют и за пределами веб-разработки. В Magnit Tech с его помощью разбирают ошибки 1С: настраивают оповещения по журналу регистрации и следят за производительностью базы. Свой сервер здесь удобен, потому что данные учётных систем остаются внутри компании.

Как собирать ошибки в сети без доступа в интернет?

На закрытых предприятиях серверы часто изолированы от внешней сети. Sentry ставят через прокси или переносят готовые образы с другой машины, а параметр SENTRY_AIR_GAP отключает все внешние сетевые обращения. Ошибки внутренних сервисов не покидают периметр.

Когда вместо Sentry лучше поставить лёгкий трекер ошибок?

Если сервер скромный и нужен только сбор ошибок, стоит посмотреть на более лёгкие системы:

Все три принимают события от SDK Sentry, поэтому переключиться можно сменой DSN. Если нужны дашборды, мониторинг производительности и полный набор интеграций, выбирайте Sentry и закладывайте под него подходящий сервер.

Какой VPS выбрать, чтобы развернуть Sentry без сбоев?

Официальные требования к серверу для self-hosted Sentry:

Разработчики рекомендуют 32 ГБ RAM, но допускают 16 ГБ, если swap лежит на быстром диске. При выборе учтите ещё несколько моментов:

Такую конфигурацию удобно собрать в облаке. В VPS от Serverspace можно выбрать локацию в Москве или Санкт-Петербурге, чтобы данные оставались в России, и задать нужные vCPU, RAM и объём диска. Когда нагрузка вырастет, ресурсы добавляются без переустановки системы, достаточно перезагрузки.

Требования к серверу для Sentry
Параметр Минимум Рекомендация Зачем это нужно
Процессор 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 apt update && sudo apt upgrade -y
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 --version
docker compose version

Если Compose старше 2.32.2, установщик Sentry остановится с ошибкой.

В мае 2024 года Docker Hub закрыл доступ для пользователей из России. Если образы не скачиваются, настройте в Docker зеркало реестра.

Как скачать нужную версию Sentry и запустить установщик?

Берите последний опубликованный релиз: в ветке master лежит код в разработке. Команды ниже сами определят номер свежей версии:

VERSION=$(curl -Ls -o /dev/null -w %{url_effective} https://github.com/getsentry/self-hosted/releases/latest)
VERSION=${VERSION##*/}
git clone https://github.com/getsentry/self-hosted.git
cd self-hosted
git checkout ${VERSION}

Перед установкой проверьте в файле .env две настройки:

Затем запустите ./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:

Без этого при входе и настройке интеграций появятся ошибки 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 подключение выглядит так:

Sentry.init({ dsn: "https://ключ@sentry.example.ru/1" });

Вызовите тестовую ошибку. Если она появилась в списке 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 fetch
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 повторяются от установки к установке. Мы собрали типичные симптомы, их причины и решения в одну таблицу.

Частые проблемы 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, если соблюдать порядок действий:

  1. Решите, нужен ли полный Sentry, профиль errors-only или лёгкий трекер.

  2. Подберите сервер не слабее официального минимума и с быстрым диском.

  3. Установите последний релиз, закройте порт 9000 и подключите домен с HTTPS.

  4. Настройте почту и отправьте тестовую ошибку.

  5. Запланируйте ежемесячные обновления и резервные копии.

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