1. Главная
  2. Хаб
  3. Сценарии
  4. Self-hosted Sentry на облачном сервере: установка, домен и HTTPS

Сценарий 10

Self-hosted Sentry на облачном сервере: установка, домен и HTTPS

Поднимаем свой Sentry для ошибок и производительности приложений: сервер на Ubuntu, официальный установщик self-hosted, домен в DNS h3llo.cloud и HTTPS через nginx и Let's Encrypt. Данные об ошибках остаются в вашем проекте.

60 минСредний7 шагов Серверы, Сети, DNS обновлено

Содержание
  1. 01Создайте группу безопасности
  2. 02Создайте сервер
  3. 03Направьте поддомен на сервер
  4. 04Подготовьте сервер: swap и Docker
  5. 05Установите Sentry
  6. 06Включите HTTPS через nginx
  7. 07Сообщите Sentry его адрес
  8. Проверка результата
  9. Как удалить ресурсы
  10. Типичные ошибки
  11. Сколько стоит

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

Sentry по адресу https://sentry.example.ru: веб-интерфейс и приём событий от SDK по HTTPS, наружу открыты только порты 22, 80 и 443, данные хранятся на диске сервера, сертификат продлевается сам.

Что понадобится

  1. Шаг 1. Создайте группу безопасности

    Sentry внутри сервера слушает порт 9000. Наружу его не открываем: снаружи доступны только SSH, HTTP и HTTPS через nginx.

    Консоль

    1. Откройте Группы безопасности и нажмите Создать. Имя — sentry, Описание — SSH, HTTP, HTTPS, нажмите Создать.
    2. На странице группы нажмите Разрешить входящий → SSH 22, затем HTTP 80 и HTTPS 443 (TCP + UDP).

    Terraform

    sentry.tf
    resource "h3_security_group" "sentry" {
      project_id  = var.project_id
      name        = "sentry"
      description = "SSH, HTTP, HTTPS"
    
      rule {
        direction   = "ingress"
        protocol    = "tcp"
        port_from   = 22
        remote_cidr = "0.0.0.0/0"
      }
      rule {
        direction   = "ingress"
        protocol    = "tcp"
        port_from   = 80
        remote_cidr = "0.0.0.0/0"
      }
      rule {
        direction   = "ingress"
        protocol    = "tcp"
        port_from   = 443
        remote_cidr = "0.0.0.0/0"
      }
      rule {
        direction   = "egress"
        remote_cidr = "0.0.0.0/0"
      }
    }

    Проверка

    Статус группы — «Применена», во входящих правилах только 22, 80 и 443.

  2. Шаг 2. Создайте сервер

    Консоль

    1. Откройте Инстансы и нажмите Создать.
    2. ОС → Образы ОС → Ubuntu 24.04 LTS. vCPU — 4, RAM — 16 ГБ, Диски — 100 ГБ, Класс производительности — «R-Стандарт».
    3. Имя виртуальной машины — sentry. SSH-ключи — ваш ключ. Публичный IPv4 — «Вкл.», «Выделить новый IP».
    4. Группы безопасности — уберите «default (по умолчанию)» и выберите sentry.
    5. Нажмите Собрать и запустить.

    Terraform

    sentry.tf (продолжение)
    resource "h3_vm" "sentry" {
      project_id = var.project_id
      name       = "sentry"
      cpu        = 4
      memory     = "16Gi"
      image      = "ubuntu:24.04"
      disk_size  = "100Gi"
      ssh_key_id = var.ssh_key_id
      white_ip   = true
    }
    
    resource "h3_vm_security_groups" "sentry" {
      vm_id              = h3_vm.sentry.id
      security_group_ids = [h3_security_group.sentry.id]
    }
    
    output "sentry_ip" {
      value = h3_vm.sentry.endpoint
    }

    CLI

    Терминал
    h3 vm create --name sentry --image ubuntu:24.04 --cpu 4 --memory 16Gi \
      --disk-size 100Gi --ssh-key-ids <id ключа> --white-ip

    Проверка

    Сервер в статусе «Работает», в карточке есть «Публичный IP» и строка «SSH подключение».

  3. Шаг 3. Направьте поддомен на сервер

    Консоль

    1. Откройте DNS → зону example.ru и нажмите Добавить запись.
    2. В окне «Новая запись»: Тип записи A, Имя sentry, в списке «Публичный IP проекта» выберите адрес сервера sentry. Нажмите Добавить.

    CLI

    Терминал
    h3 dns record set <id зоны> sentry A --records <IP сервера> --ttl 300

    Проверка

    Имя отвечает адресом сервера:

    Терминал
    dig +short sentry.example.ru
  4. Шаг 4. Подготовьте сервер: swap и Docker

    Установщику Sentry нужны Docker, Docker Compose v2 и 16 ГБ swap в дополнение к RAM.

    На сервере (ssh user@<IP>)
    # swap 16 ГБ
    sudo fallocate -l 16G /swapfile && sudo chmod 600 /swapfile
    sudo mkswap /swapfile && sudo swapon /swapfile
    echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
    
    # Docker Engine и плагин compose из официального репозитория Docker
    curl -fsSL https://get.docker.com | sudo sh
    sudo usermod -aG docker user && newgrp docker

    Проверка

    free -h показывает Swap 16G, а Docker и Compose отвечают версиями:

    Терминал
    docker --version && docker compose version
  5. Шаг 5. Установите Sentry

    Ставьте последний выпуск, а не ветку master. Установщик скачает образы, создаст тома и проведёт миграции — это занимает 10–20 минут.

    На сервере
    git clone https://github.com/getsentry/self-hosted.git ~/sentry && cd ~/sentry
    git checkout "$(git describe --tags --abbrev=0)"     # последний выпуск
    ./install.sh --skip-user-creation
    docker compose up --wait
    docker compose run --rm web createuser                # первый пользователь — суперпользователь

    Проверка

    docker compose ps показывает контейнеры в состоянии running или healthy, а локально отвечает веб-интерфейс:

    Терминал
    curl -sI http://127.0.0.1:9000/ | head -n 1

    Если не получилось

    • Установщик останавливается на проверке ресурсов — у сервера меньше 4 vCPU или 16 ГБ RAM. Увеличьте vCPU и RAM в карточке сервера и запустите ./install.sh снова.
    • Контейнеры перезапускаются с OOMKilled — не включён swap: проверьте swapon --show.
  6. Шаг 6. Включите HTTPS через nginx

    nginx на сервере принимает HTTPS на 443 и проксирует в Sentry на 127.0.0.1:9000. Сертификат выпускает certbot.

    /etc/nginx/sites-available/sentry
    server {
        listen 80;
        server_name sentry.example.ru;
        client_max_body_size 100m;
    
        location / {
            proxy_pass http://127.0.0.1:9000;
            proxy_set_header Host $host;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }
    }
    На сервере
    sudo apt update && sudo apt install -y nginx certbot python3-certbot-nginx
    sudo nano /etc/nginx/sites-available/sentry      # вставьте конфиг выше
    sudo ln -s /etc/nginx/sites-available/sentry /etc/nginx/sites-enabled/
    sudo nginx -t && sudo systemctl reload nginx
    sudo certbot --nginx -d sentry.example.ru --redirect

    Проверка

    https://sentry.example.ru открывает страницу входа Sentry с действительным сертификатом.

  7. Шаг 7. Сообщите Sentry его адрес

    Без этого ссылки в письмах и DSN проектов будут указывать на http://…:9000, а вход через HTTPS отклонит проверка CSRF.

    В sentry/config.yml задайте system.url-prefix. В sentry/sentry.conf.py раскомментируйте настройки для работы за TLS-прокси (SECURE_PROXY_SSL_HEADER, USE_X_FORWARDED_HOST, SESSION_COOKIE_SECURE, CSRF_COOKIE_SECURE, SOCIAL_AUTH_REDIRECT_IS_HTTPS) и добавьте домен в CSRF_TRUSTED_ORIGINS.

    ~/sentry/sentry/config.yml (фрагмент)
    system.url-prefix: 'https://sentry.example.ru'
    ~/sentry/sentry/sentry.conf.py (фрагмент)
    SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')
    USE_X_FORWARDED_HOST = True
    SESSION_COOKIE_SECURE = True
    CSRF_COOKIE_SECURE = True
    SOCIAL_AUTH_REDIRECT_IS_HTTPS = True
    CSRF_TRUSTED_ORIGINS = ["https://sentry.example.ru"]
    На сервере
    cd ~/sentry && docker compose restart

    Проверка

    Вход по https://sentry.example.ru проходит, а DSN в настройках нового проекта начинается с https://…@sentry.example.ru/.

Проверка результата

Отправьте тестовое событие с любого компьютера — оно появится в разделе Issues проекта через несколько секунд.

Терминал
pip install sentry-sdk
python3 -c "import sentry_sdk; sentry_sdk.init('<DSN проекта>'); sentry_sdk.capture_message('hello from h3llo.cloud'); sentry_sdk.flush()"

Как удалить ресурсы

Все данные Sentry лежат на диске сервера: удаление сервера удаляет и их.

Terraform

Terraform
terraform destroy
  1. Инстансы → sentry → меню «…» → Удалить; отметьте «Освободить IP-адрес (иначе он останется в проекте)».
  2. Удалите запись sentry в зоне DNS и группу безопасности sentry.

Типичные ошибки

Можно ли вынести ClickHouse, Kafka и PostgreSQL Sentry в управляемые базы h3llo.cloud?

Установщик self-hosted разворачивает свои закреплённые версии ClickHouse, Kafka, PostgreSQL и Redis и рассчитан на них. Управляемые ClickHouse и Kafka в h3llo.cloud принимают только TLS-подключения, Kafka — ещё и с логином SCRAM; в стандартной сборке Sentry такие подключения не настраиваются, и мы этот вариант не проверяли. Рабочий путь сегодня — сервер целиком, как в этом сценарии.

Как обновить Sentry?

В каталоге `~/sentry`: `git fetch --tags`, `git checkout <новый выпуск>`, `./install.sh --skip-user-creation`, `docker compose up --wait`. Перед обновлением выгрузите настройки: `docker compose run --rm -T web export > ~/sentry-backup.json`. Выпуски нельзя перепрыгивать через обязательные промежуточные — их список в заметках к выпускам self-hosted.

Место на диске кончается

Уменьшите `SENTRY_EVENT_RETENTION_DAYS` в `~/sentry/.env` и выполните `docker compose up --wait` или увеличьте диск сервера: диски растут онлайн, без остановки машины.

Сколько стоит такой Sentry?

Сервер 4 vCPU и 16 ГБ RAM с диском 100 ГБ и публичным IP — 900 ₽ за vCPU, 360 ₽ за ГБ RAM и 14,40 ₽ за ГБ диска в месяц плюс адрес. Итог — в блоке «Сколько стоит» ниже.

Связанные продукты и материалы

Сколько стоит

≈ 15,13 ₽ в час · 10 890 ₽ в месяц при работе 24/7

vCPU сервера4 × 900 ₽
RAM сервера, ГБ16 × 360 ₽
Диск до 20 000 IOPS*, ГБ100 × 14,40 ₽
Публичный IPv41 × 90 ₽

Минимум для self-hosted Sentry — 4 vCPU и 16 ГБ RAM плюс 16 ГБ swap. Диск растёт вместе с числом событий: срок хранения задаёт SENTRY_EVENT_RETENTION_DAYS (по умолчанию 90 дней). Исходящий трафик сервера не тарифицируется.

Цены из прайс-листа, по которому работает биллинг; списание поминутное, месяц — 720 часов. Если удалить ресурсы после проверки, сценарий обойдётся в рубли.

Новым пользователям — 4 000 ₽ на 30 дней на любые сервисы: бонуса хватит, чтобы попробовать этот сценарий целиком. Бонус начисляется после подтверждения телефона и привязки карты.

* IOPS растут с объёмом диска; точные значения для вашего объёма видны в консоли при выборе.