Sentry

Sentry是一套搜集错误讯息的软件，或是对应的云端服务。

硬件

官方推估每天处理四百万的事件，资料保留90天，大约需要1.5 TB的空间。

简介

Sentry提供SDK在用户端安装后就可以搜集错误资讯，并且在服务器上分类并提供界面让维护者可以确认情况。

安装

这边以Ubuntu 22.04为操作系统，需要先安装Docker与Docker Compose（要注意得安装Ubuntu套件库提供的版本），并且设定权限：

sudo apt install docker-compose

sudo groupadd -g 9000 service-sentry
sudo useradd -g 9000 -G docker -m -s /bin/bash -u 9000 service-sentry

然后装到service-sentry下：

sudo su - service-sentry -c "git clone https://github.com/getsentry/self-hosted.git; cd self-hosted; git checkout 23.7.2; ./install.sh; docker compose up -d"

升级

先切到self-hosted的目录下：

cd self-hosted; docker compose down; git pull; git checkout 23.7.2; ./install.sh; docker compose up -d

设定

Google OAuth

参考Self-Hosted Single Sign-On (SSO)这边的设定：

• 需要先到Google端建立应用程序。
  • 其中文章里没有提到的是Google端的redirect_uri设定需要设为https://sentry.example.com/auth/sso/。
• 再把应用程序对应的client id与client secret填到sentry/config.yml内，再重启Sentry。

Slack

参考Slack Integration这边的设定。

除错

可以先用docker-compose的logs -f看错误讯息：

docker-compose logs -f

外部链接

• 官方网站 （英文）
• Sentry On-Premise setup （英文）
• Docs - Sentry Server （英文）