Sentry на VPS: трекинг ошибок для своего приложения

fallocate -l 16G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile

# Сделать постоянным
echo '/swapfile none swap sw 0 0' >> /etc/fstab

# Проверить
free -h

# Зависимости
apt update && apt install -y ca-certificates curl gnupg

# GPG-ключ Docker
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg   -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

# Репозиторий
echo   "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc]   https://download.docker.com/linux/ubuntu   $(. /etc/os-release && echo "$VERSION_CODENAME") stable"   | tee /etc/apt/sources.list.d/docker.list > /dev/null

apt update
apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# Проверить
docker --version
docker compose version

# Определить последнюю версию
VERSION=$(curl -Ls -o /dev/null -w %{url_effective} \
  https://github.com/getsentry/self-hosted/releases/latest)
VERSION=${VERSION##*/}
echo "Устанавливаем Sentry $VERSION"

# Клонировать
git clone https://github.com/getsentry/self-hosted.git /opt/sentry
cd /opt/sentry
git checkout $VERSION

cd /opt/sentry
./install.sh

cd /opt/sentry
docker compose up --wait -d

cat > /etc/systemd/system/sentry.service << 'EOF'
[Unit]
Description=Sentry
After=docker.service
Requires=docker.service

[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/opt/sentry
ExecStart=/usr/bin/docker compose up -d --wait
ExecStop=/usr/bin/docker compose down
TimeoutStartSec=300

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable sentry

apt install -y nginx certbot python3-certbot-nginx

server {
    listen 80;
    server_name sentry.ваш-домен.ru;

    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Для больших payload (source maps)
        client_max_body_size 100M;

        # Таймауты для долгих запросов
        proxy_read_timeout 300;
        proxy_connect_timeout 300;
    }
}

ln -s /etc/nginx/sites-available/sentry /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

# Получить SSL-сертификат
certbot --nginx -d sentry.ваш-домен.ru

system.url-prefix: 'https://sentry.ваш-домен.ru'

cd /opt/sentry && docker compose restart web worker

pip install sentry-sdk

import sentry_sdk

sentry_sdk.init(
    dsn="https://abc123@sentry.ваш-домен.ru/2",
    # Процент запросов для трассировки производительности (1.0 = 100%)
    traces_sample_rate=0.1,
    # Включить профилирование
    profiles_sample_rate=0.1,
    # Окружение (помогает фильтровать события в интерфейсе)
    environment="production",
    # Версия приложения (для отслеживания когда ошибка появилась)
    release="my-app@1.0.0",
)

# Тест: это исключение появится в Sentry
# raise ValueError("Тестовая ошибка")

pip install sentry-sdk[django]

import sentry_sdk

sentry_sdk.init(
    dsn="https://abc123@sentry.ваш-домен.ru/2",
    integrations=[
        sentry_sdk.integrations.django.DjangoIntegration(),
    ],
    traces_sample_rate=0.1,
    send_default_pii=True,  # Привязывает пользователей к ошибкам
    environment="production",
)

pip install sentry-sdk[fastapi]

import sentry_sdk
from sentry_sdk.integrations.fastapi import FastApiIntegration
from sentry_sdk.integrations.starlette import StarletteIntegration
from fastapi import FastAPI

sentry_sdk.init(
    dsn="https://abc123@sentry.ваш-домен.ru/2",
    integrations=[
        StarletteIntegration(),
        FastApiIntegration(),
    ],
    traces_sample_rate=0.1,
    environment="production",
)

app = FastAPI()

from sentry_sdk import set_user

# Например, в middleware после проверки токена
set_user({"id": user.id, "email": user.email, "username": user.username})

npx @sentry/wizard@latest -i nextjs

import * as Sentry from "@sentry/nextjs";

Sentry.init({
  dsn: "https://abc123@sentry.ваш-домен.ru/2",
  tracesSampleRate: 0.1,
  environment: "production",
  // Опционально: Session Replay для видео воспроизведения ошибки
  replaysSessionSampleRate: 0,
  replaysOnErrorSampleRate: 1.0,
});

import * as Sentry from "@sentry/nextjs";

Sentry.init({
  dsn: "https://abc123@sentry.ваш-домен.ru/2",
  tracesSampleRate: 0.1,
  environment: "production",
});

import { withSentryConfig } from "@sentry/nextjs";

const nextConfig = {
  // ваша конфигурация
};

export default withSentryConfig(nextConfig, {
  org: "your-org",
  project: "my-nextjs-app",
  // Загрузка source maps на Sentry (для читаемых стектрейсов)
  sourcemaps: {
    disable: false,
  },
  // Подавить логи при сборке
  silent: !process.env.CI,
  // Не блокировать билд если Sentry недоступен
  errorOnFailedUpload: false,
});

npm install @sentry/node

// ВАЖНО: инициализация должна быть до import Express и других модулей
const Sentry = require("@sentry/node");

Sentry.init({
  dsn: "https://abc123@sentry.ваш-домен.ru/2",
  tracesSampleRate: 0.1,
  environment: "production",
});

const express = require("express");
const app = express();

// Sentry middleware — первым после создания app
Sentry.setupExpressErrorHandler(app);