前提

项目上线之后，线上问题尤其是线上报错导致的页面无法正常渲染是非常严重的问题。一个异常监控服务可以及时报警通知、提供有效信息和报错堆栈等排查问题。调研了部分异常监控服务以及自研成本之后，决定选择自行搭建 Sentry 这款异常监控服务。Sentry 提供 SaaS 服务也提供自行搭建部署，并且搭建部署也是非常简单方便，在功能使用上面也非常全面易用、支持多平台。

市面上也还有其他优秀的异常监控服务 阿里云 ARMS, 岳鹰, 腾讯 Badjs, Fundebug, FrontJS 等等等等

准备

  1. 一台服务器，由于运行了 kafka, zookeeper 等等服务并且如果后续接入业务流量较大还是需要一定配置，建议服务器规格至少 4G 内存，条件运行可以 8G 内存，官方文档中说明至少需要 2400MB RAM 。这里使用的是 Google Cloud 上的 n1-standard-1 (1 vCPU, 3.75 GB memory) 搭配 CentOS 7 演示，在公司内部搭建的是阿里云的服务器。
  2. 一个可以提供 smtp 端口发邮件的邮箱，由于用户注册、报警通知等都会通过发送邮件所以邮箱还是近乎必须的
  3. 部分 git, shell, docker 的知识

Docker

Sentry On-Premise 的安装脚本使用 Docker 和 Docker Compose, 可以很方便的搭建起来。所以我们先在服务器上搭建 Docker

以下命令都在 root 用户下操作，这里先切换成超级用户

  1. sudo -i

参考 Docker 文档安装 docker，如果需要安装特定版本或者不同操作系统，官方文档都提供了不同的安装方法可以参考阅读

  1. # 安装 yum-utils
  2. yum install -y yum-utils
  4. # 添加 docker 官方仓库
  5. yum-config-manager \
  6.   --add-repo \
  7.   https://download.docker.com/linux/centos/docker-ce.repo
  9. # 安装最新版的 docker
  10. yum install docker-ce docker-ce-cli containerd.io
  12. # 启动 docker
  13. systemctl start docker
  15. # 测试 docker 是否安装成功
  16. docker run hello-world

还需要 docker-compose 所以也参考官方文档安装，如果国内服务器连接 Github 速度较慢可以使用一些国内的镜像

  1. # 从 github 上下载 docker-compose
  2. curl -L "https://github.com/docker/compose/releases/download/1.26.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
  4. # 使 docker-compose 可执行
  5. chmod +x /usr/local/bin/docker-compose
  7. # 添加软链方便使用
  8. ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
  10. # 运行下确认版本及安装成功
  11. docker-compose --version

部署 Sentry

安装 Git 来克隆项目

  1. yum install git

克隆项目，切换到对应版本分支，master 分支为开发分支并不稳定建议切换为对应版本分支，自从 10.0.x 之后 Sentry 的版本规则从 SemVer 切换到了 CalVer

  1. mkdir /home/admin
  2. cd /home/admin
  3. git clone https://github.com/getsentry/onpremise.git
  4. cd onpremise
  5. git checkout releases/20.0.8

克隆完项目之后，我们需要修改一些配置再执行安装脚本，比如配置发送邮件的邮箱，配置额外的插件（如钉钉推送等）

下面是克隆下来的项目目录

  1. ├── .craft.yml
  2. ├── .env # 环境参数
  3. ├── .gitignore
  4. ├── .travis.yml
  5. ├── LICENSE
  6. ├── README.md
  7. ├── cron
  8. │   ├── Dockerfile
  9. │   └── entrypoint.sh
  10. ├── docker-compose.yml # docker-compose 文件
  11. ├── install.sh # 安装脚本
  12. ├── nginx # nginx 配置
  13. │   └── nginx.conf
  14. ├── relay
  15. │   └── config.example.yml
  16. ├── scripts
  17. │   └── bump-version.sh
  18. ├── sentry # sentry 的自定义配置，如邮箱配置、额外插件等等
  19. │   ├── .dockerignore
  20. │   ├── Dockerfile
  21. │   ├── config.example.yml
  22. │   ├── requirements.example.txt
  23. │   └── sentry.conf.example.py
  24. ├── symbolicator
  25. │   └── config.example.yml
  26. ├── test.sh
  27. └── zookeeper
  28.     └── snapshot.0

复制一份 config.example.yml 为 config.yml 修改邮箱配置

  1. cp sentry/config.example.yml sentry/config.yml

如果你的服务器支持 25 端口的邮箱发送，并且不打算使用加密协议 TLS 或者 SSL 发送邮件可以直接修改下面相应的配置 25 端口即可。这里使用的是阿里云的邮箱，也可以使用其他任意邮箱服务提供商。

sentry/config.yml

  1. #mail.backend: "smtp" # Use dummy if you want to disable email entirely
  2. mail.host: "smtp.aliyun.com"
  3. mail.port: 25
  4. mail.username: "youremail@aliyun.com"
  5. mail.password: "yourpassword"
  6. mail.use-tls: false
  7. # The email address to send on behalf of
  8. mail.from: "youremail@aliyun.com"

由于 Google Cloud 上的服务器禁止了 25 端口发送邮件，所以我们需要额外配置使用 TLS 并且使用端口 465

先复制一份 requirements.example.txt 为 requirements.txt 加两个插件，支持 TLS 发送邮件以及钉钉通知插件

  1. cp sentry/requirements.example.txt sentry/requirements.txt

sentry/requirements.txt

  1. # Add plugins here
  2. sentry-dingtalk-new
  3. django-smtp-ssl~=1.0

sentry/config.yml

  1. mail.backend: "django_smtp_ssl.SSLEmailBackend" # Use dummy if you want to disable email entirely
  2. mail.host: "smtp@aliyun.com"
  3. mail.port: 465
  4. mail.username: "youremail@aliyun.com"
  5. mail.password: "yourpassword"
  6. mail.use-tls: true
  7. # The email address to send on behalf of
  8. mail.from: "youremail@aliyun.com"

如果还需要其他额外配置可以单独修改对应配置。比如 nginx 的配置在 10.0.x 的版本可能上传文件的最大大小是比较小的需要修改以下

配置好后就可以执行安装脚本

  1. ./install.sh

等待安装脚本执行完成没有问题会提示以下信息

  1. ----------------
  2. You're all done! Run the following command to get Sentry running:
  4.   docker-compose up -d

执行 docker-compose up -d 启动服务并且打开 9000 端口访问 🎉

image.png

服务器的出入站规则记得开放 9000 端口访问。后续也可以单独配置域名，和 https 证书，或者这部分由运维同学负责

Sentry 日常维护、日志查看

  1. # 查看当前运行的容器列表
  2. docker ps
  4. # 查看镜像列表
  5. docker image ls
  7. # 查看各个容器的状态，CPU、内存占用等
  8. docker stats
  10. # 查看 docker-compose 对应的容器状态
  11. docker-compose ps
  13. # 查看日志
  14. docker-compose logs -f
  16. # 停止服务
  17. docker-compose down
  19. # 启动服务
  20. docker-compose up -d
  22. # 查看系统内存占用
  23. free -m
  25. # 查看进程和系统状态
  26. top

常见问题

Q. 搭建成功之后邮件发送失败

A. 可以看下 config.yml 里的邮箱配置是否正确，服务器的 25 或者 465 端口是否开开放。可以登录之后在系统管理目录下 manage/status/mail/ 发送测试邮件。修改配置之后重新执行 ./install.sh 后会重新打包镜像即可

Q. 如何修改语言

A. 在用户设置目录下 settings/account/details/, 还可以修改时区

不同平台接入异常监控 Sentry SDK

接入 SDK 这个再单独写成文章。或者也可以参考接入文档

Reference