Новости
Обновление услуги LLM: управление API-ключами, моделями и расходами
AA
Artemy Arhipov
октября 23, 2026
Обновлено октября 28, 2026

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

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

Развернуть 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-контейнерах. Путь одной ошибки выглядит так:

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

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

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

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

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

  6. Веб-интерфейс показывает новую 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 и объём диска. Когда нагрузка вырастет, ресурсы добавляются без переустановки системы, достаточно перезагрузки.

Требования к серверу для 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 две настройки:

  • 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 подключение выглядит так:

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: начните с официального минимума и расширяйте конфигурацию, когда вырастет число проектов и событий.

Вам также может быть интересно...