Sentry 监控 - 私有 Docker Compose 部署与故障排除详解

最新推荐文章于 2025-03-19 17:03:06 发布

为为少

最新推荐文章于 2025-03-19 17:03:06 发布

阅读量1k

点赞数

文章标签： linux java 数据库 python 大数据

本文链接：https://blog.youkuaiyun.com/o__cc/article/details/121943805

版权

本文详细介绍了如何使用 Docker Compose 部署自托管 Sentry，涵盖入门、配置、升级、备份与恢复等步骤，并提供了故障排除策略，包括 Kafka、Redis 和 Postgres 的问题解决方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

内容整理自官方开发文档

系列

自托管 Sentry

除了公开提供其源代码外，Sentry 还提供并维护了一个最小的设置，可以为简单的用例开箱即用。
该存储库还可以作为各种 Sentry 服务如何连接以进行完整设置的蓝图，这对于愿意维护更大安装的人很有用。
为简单起见，我们为此选择使用 Docker 和 Docker Compose，
以及基于 bash 的安装和升级脚本。

入门

我们的建议是下载自托管存储库的最新版本，
然后在此目录中运行 ./install.sh。
这个脚本会处理你开始需要的所有事情，包括一个 base-line 配置，
然后会告诉你运行 docker-compose up -d 来启动 Sentry。Sentry 默认绑定到端口 9000。
您应该能够访问 http://127.0.0.1:9000 上的登录页面。

https://github.com/getsentry/self-hosted/releases/latest

配置

您很可能希望调整 Sentry 的默认配置。这些设施可用于此目的：

sentry/config.yml — 包含大多数(如果不是全部)要调整的配置选项。这个文件是在安装时从 sentry/config.example.yml 生成的。该文件本身将最常见的配置选项记录为代码注释。此文件中的一些常用设置包括：
- system.url-prefix(我们会在安装后立即提示您在欢迎屏幕上进行设置)
- mail.*(虽然我们提供了一个基本的 SMTP 服务器)
- GitHub、Slack 等的集成。
sentry/sentry.conf.py—包含更高级的配置。这个文件是在安装过程中从 sentry/sentry.conf.example.py 生成的。
- https://github.com/getsentry/self-hosted/blob/master/sentry/sentry.conf.example.py
环境变量—可用的 key 在 .env 中定义。如果您需要覆盖任何环境变量，请使用一些与系统相关的方法来设置环境变量。为避免 Git 更改，只需创建一个名为 .env.custom 的文件并在其中插入与系统相关的环境变量。为了使用它，请使用 docker-compose --env-file /path/to/.env.custom up -d。
Geolocation 使用自定义配置文件来符合底层技术。

注意：更改配置后，您需要通过运行 docker-compose restart web worker cron sentry-cleanup(或仅 docker-compose restart 重新启动所有内容)来重新启动所有 Sentry 服务。

配置特定主题

以下是与自托管相关的特定配置主题的更多信息：

自定义 CA 根
Email
地理位置
单点登录 (SSO)

产品化

我们强烈建议在绑定到专用域或子域的 Sentry 设置前使用专用负载均衡器。
一个执行 SSL/TLS 终止的专用负载平衡器也将客户端 IP 地址转发为 Docker Compose 内部网络
(因为这几乎不可能以其他方式获得)将为您提供最佳的 Sentry 体验。
作为此设置的一部分，我们建议使用 HTTP 协议针对 /_health/ 端点配置负载均衡器运行状况检查。
如果 Sentry 启动，这将返回 200

最低0.47元/天解锁文章