如何在云服务器上搭建Sentry错误监控系统？完整指南

一、准备工作

1.1 选择合适的云服务器

推荐配置：

• CPU：至少4核
• 内存：8GB以上
• 存储：50GB SSD
• 操作系统：Ubuntu 20.04 LTS或CentOS 7+

小贴士：阿里云、腾讯云等主流云服务商都提供满足需求的实例类型。

1.2 必备组件安装

# Ubuntu/Debian
sudo apt update
sudo apt install -y docker docker-compose git python3-pip

# CentOS/RHEL
sudo yum install -y docker git python3-pip
sudo systemctl start docker
sudo systemctl enable docker

二、安装Sentry

2.1 克隆官方仓库

git clone https://github.com/getsentry/onpremise.git
cd onpremise

2.2 配置环境变量

编辑.env文件，设置关键参数：

SENTRY_SECRET_KEY=your-secret-key-here
SENTRY_SINGLE_ORGANIZATION=true
SENTRY_EMAIL_HOST=smtp.yourdomain.com

2.3 构建并启动容器

./install.sh
docker-compose up -d

三、系统配置

3.1 初始化数据库

docker-compose run --rm web upgrade

3.2 创建超级用户

docker-compose run --rm web createuser

3.3 配置Nginx反向代理

示例配置：

server {
    listen 80;
    server_name sentry.yourdomain.com;
    
    location / {
        proxy_pass http://localhost:9000;
        proxy_set_header Host $host;
        proxy_redirect off;
    }
}

四、项目集成

4.1 获取DSN

登录Sentry控制台 → 项目 → 客户端密钥

4.2 常见语言SDK配置

Python示例：

import sentry_sdk
sentry_sdk.init("your-dsn-here")

JavaScript示例：

import * as Sentry from '@sentry/browser';
Sentry.init({ dsn: 'your-dsn-here' });

五、进阶配置

5.1 邮件通知设置

确保.env文件中SMTP配置正确：

SENTRY_EMAIL_HOST=smtp.example.com
SENTRY_EMAIL_PORT=587
[email protected]
SENTRY_EMAIL_PASSWORD=yourpassword
[email protected]

5.2 数据备份策略

建议定期备份PostgreSQL数据和Redis数据：

# 备份PostgreSQL
docker exec -t sentry_postgres pg_dumpall -c -U postgres > dump_`date +%d-%m-%Y"_"%H_%M_%S`.sql

# 备份Redis
docker exec sentry_redis redis-cli save

5.3 性能优化

• 为PostgreSQL配置专用存储卷
• 增加Worker节点数量
• 启用缓存机制

六、常见问题解决

6.1 容器启动失败

检查日志：docker-compose logs，常见原因是端口冲突或内存不足。

6.2 邮件发送失败

验证SMTP配置，测试连接：telnet smtp.yourdomain.com 587

6.3 数据不显示

确认SDK配置正确，检查网络连接是否被防火墙拦截。