SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

自托管错误追踪:Sentry 替代方案对比

自托管 Sentry 完整版需 16GB 内存,而 GlitchTip 仅需 512MB。本文对比各方案的内存占用、磁盘增长及升级维护成本,助您根据服务器资源选择最合适的错误追踪工具。

自托管错误追踪在存储单个事件前的成本

自托管错误追踪的选型取决于一个核心指标:内存基准。Sentry 的官方自托管文档要求在应用发送任何事件之前,完整功能栈需配备 4 核 CPU、16 GB 内存(外加 16 GB 交换空间)以及 20 GB 可用磁盘空间。其仅限错误追踪的配置门槛较低:需 2 核 CPU 和 7000 MB 可供 Docker 使用的内存。GlitchTip 则要求 512 MB 内存。此处所有选项均兼容相同的 Sentry SDK,因此这并非关于如何埋点代码的决策,而是关于你愿意为多大规格的服务器付费并维持其运行的决策。

已发布的资源数据对比

以下是各项目截至 2026 年 10 月自行发布的数据。由于衡量标准不同,请在对比前阅读每一行的说明。

图表Published RAM figures per error tracking stack, October 2026
此图表背后的数据
[
  {
    "tool": "Sentry feature-complete",
    "published_ram_gb": 16,
    "notes": "documented minimum for the feature-complete profile, plus 16 GB of swap"
  },
  {
    "tool": "Bugsink",
    "published_ram_gb": 4,
    "notes": "the vendor's own published benchmark box, 2 vCPU"
  },
  {
    "tool": "GlitchTip",
    "published_ram_gb": 0.5,
    "notes": "documented recommendation, 256 MB stated as the minimum"
  }
]

Sentry 的 16 GB 是其功能完整配置下的文档化最低要求,同一页面建议使用 32 GB。GlitchTip 的 0.5 GB 是一项建议值,该项目称 256 MB 为运行最低要求,若配置得当,128 MB 加交换分区(swap)也可运行。Bugsink 的 4 GB 既非上述两者:它是供应商在进行自身吞吐量基准测试时所使用的硬件规格。已发布的数据仅供参考,并非对您实际事件处理量的承诺。

Sentry 自托管:大部分产品功能与全部运维成本

官方技术栈是 getsentry/self-hosted,这是一个 Docker Compose 项目,运行着 Sentry 在生产环境中使用的所有组件。其文档列出了排除项,包括 Seer 以及其他闭源的 AI 和 ML 功能、计费、流量激增保护及部分平台支持。你将获得大部分 Sentry 功能,以及支撑这些功能运行的各个组件。

请从已标记的 release 版本安装,而非直接从 master 安装:

VERSION=$(curl -Ls -o /dev/null -w %{url_effective} https://github.com/getsentry/self-hosted/releases/latest)
VERSION=${VERSION##*/}
git clone https://github.com/getsentry/self-hosted.git
cd self-hosted
git checkout ${VERSION}
./install.sh

默认配置为功能全量版。若要安装仅包含错误追踪的精简版,请在运行 ./install.sh 前,在 .env 中设置 COMPOSE_PROFILES=errors-only。

随后启动服务:

docker compose up --wait

Sentry 默认在所有主机接口上发布 9000 端口;若要将其绑定到 localhost,请在 .env 中设置 SENTRY_BIND=127.0.0.1:9000。系统要求 Docker Engine 19.03.6 或更高版本,以及 Docker Compose 2.32.2 或更高版本,安装程序会检查这两项:若 Compose 版本过旧,./install.sh 会停止运行,并显示一行以 FAIL: Expected minimum 开头的错误信息,其中包含检测到的版本号,随后脚本会报错退出。在 x86-64 主机上,官方 ClickHouse 26.6 及更高版本的镜像要求 CPU 支持完整的 x86-64-v3 指令集,包括 AVX2。

查看你实际启动的服务:

docker compose ps
free -h

docker compose ps 会列出技术栈中的每一个服务,列表很长:Postgres、ClickHouse、Kafka、Valkey(在 Compose 服务名称中为 redis)、Relay、Snuba、Symbolicator,以及多个 worker 和 cron 进程。请务必清点这些服务,因为这个数量代表了你的维护负载。每一项都是一个可能崩溃、占满磁盘或在迁移过程中失败的进程。

如果某个服务处于 Restarting 状态,请首先检查内存:

dmesg -T | grep -i 'out of memory'

出现类似 Out of memory: Killed process 3412 (java) 的行,意味着内核的 OOM killer(内存溢出杀手)因为物理机内存耗尽而杀死了容器,导致该服务无法进入健康状态,整个技术栈也无法完成启动。安装程序还会检查可用内存,并拒绝在低于强制最低要求的机器上安装。文档还指出了磁盘速度问题:iowait 超过 10% 通常意味着机器无法跟上数据摄入流水线。你可以通过 top 中的 wa 列查看该指标,或者在安装了 sysstat 的情况下通过 iostat -x 5 查看。

升级是人们最容易低估的部分

Sentry 自托管版本每月发布一次,采用 CalVer(基于日期的版本命名方案),主要版本发布日期为每月 15 日。你不能从旧版本直接跳跃到最新版本。该项目定义了硬性停止版本(hard stop versions),你必须按顺序检出每一个版本,以确保执行必要的数据库迁移。截至 2026 年 10 月,已发布的硬性停止版本包括 9.1.2、21.5.0、21.6.3、23.6.2、23.11.0、24.8.0、25.5.1、26.5.0 和 26.7.0。文档还列出了因迁移问题需要跳过的版本,包括 23.7.0、25.9.0、25.12.0 以及 26.3.0 到 26.4.0 范围内的版本。

升级过程包括检出代码并重新运行安装程序:

git fetch
git checkout 26.7.0
./install.sh
docker compose up --wait

在开始之前请对服务器进行快照,因为针对大型 ClickHouse 数据集的迁移可能持续数小时,若中途失败,数据库将处于两种模式之间的中间状态。大多数自托管 Sentry 升级失败的根本原因在于:服务器长期未更新,导致一次性跨越了多个硬性停止版本,而其中被跳过的某个迁移步骤至关重要。

在决定使用前,还有一点需要了解。Sentry 自托管版本采用 Sentry 自行推出的功能性源码许可(Functional Source License, FSL)。这属于“公平源码”(fair source)而非 OSI 认证的开源软件:你可以自行运行,但不得将其作为竞争性服务进行销售。每个版本在发布两年后会自动转换为 Apache 2.0 协议。

GlitchTip:512 MB 方案

GlitchTip 使用 MIT 许可证,并接收来自 Sentry 开源 SDK 的事件,因此已接入监控的应用只需修改一个值即可迁移:DSN(数据源名称,即 SDK 发布事件的 URL)。GlitchTip 7.0 要求 PostgreSQL 15 或更高版本。Valkey 或 Redis 7 或更高版本是可选项,可提升较大实例的速度。

安装只需 Docker 和一个 compose 文件:

sudo apt install docker.io
curl -O https://glitchtip.com/assets/compose.sample.yml
mv compose.sample.yml compose.yml

在启动任何服务前,先编辑环境变量部分。设置密钥和域名。如果需要邮件告警和密码重置,再配置邮件:

SECRET_KEY: <output of openssl rand -base64 50>
GLITCHTIP_DOMAIN: https://errors.example.com
DEFAULT_FROM_EMAIL: errors@example.com
EMAIL_URL: smtp://user:password@smtp.example.com:587

将 DATABASE_URL 设置为此安装使用的 PostgreSQL 连接字符串。GLITCHTIP_DOMAIN 必须包含 scheme。如果开头没有 https://,告警邮件中的链接会生成错误,并指向无法访问的 URL。

启动服务并监控首次启动过程:

docker compose up -d
docker compose logs -f web

固定镜像标签。写有 latest 的 compose 文件会在下一个 docker compose pull 获取新的数据库引擎,并在下次 docker compose up -d 重建容器时切换到该引擎。在现有数据目录上直接升级 PostgreSQL 主版本,可能导致原本正常运行的错误跟踪器无法启动。

要控制在 256 MB 到 512 MB 范围内,请禁用 Valkey 以及可选的日志和运行时间监控功能。不使用 Valkey 时,GlitchTip 会改用数据库处理缓存和队列任务。速度会变慢,但功能仍然正确。All in one 模式会将 worker 运行在 Web 进程中,因此只需维护一个应用容器,而不是两个。

在 GlitchTip 前面放置代理。GlitchTip 文档要求使用能够缓冲请求并处理分块 Transfer-Encoding 的代理或负载均衡器,并以 nginx 作为示例。如果不进行缓冲,慢速客户端会在整个上传期间占用一个应用 worker。因此,少量慢速发送方就可能占满所有 worker,导致正常客户端开始超时。

跨主版本升级前,先阅读发布说明。对于 GlitchTip 7.0,如果当前使用 5.x,应先升级到 6.x;并应在仍使用 GlitchTip 6.x 时升级 PostgreSQL 14。在将应用镜像标签改为 7 之前,检查已重命名的环境变量、已删除的启动设置、新的 TRUSTED_PROXIES 默认值以及权限变化。然后拉取镜像并重启:

docker compose pull
docker compose stop
docker compose up -d

数据库迁移会在启动时自动运行。但仍应先创建转储,因为自动迁移仍然是迁移。

Bugsink:单容器部署与必须阅读的许可协议

Bugsink 是这三款工具中最轻量级的。它兼容 Sentry SDK 协议,运行时无需消息队列,除数据库外不依赖任何外部服务。默认使用 SQLite,当数据量超出其承载能力时,可切换至 MySQL 或 PostgreSQL。

若要在正式部署前预览界面,可运行一次性实例:

docker pull bugsink/bugsink:latest
docker run \
  -e SECRET_KEY=PUT_AN_ACTUAL_RANDOM_SECRET_HERE_OF_AT_LEAST_50_CHARS \
  -e CREATE_SUPERUSER=admin@example.org:admin \
  -e PORT=8000 \
  -p 8000:8000 \
  bugsink/bugsink

打开 http://localhost:8000/ 并使用你在 CREATE_SUPERUSER 中设置的地址和密码登录。该容器在移除后会丢失所有数据。如需正式实例,请使用项目提供的 compose 示例,它将 bugsink/bugsink:2 与 postgres:17-alpine 配合使用,并设置 DATABASE_URL、BASE_URL 和 BEHIND_HTTPS_PROXY。请按如下方式正确生成密钥:

openssl rand -base64 50

BASE_URL 必须与用户和 SDK 实际访问的 URL 一致,包括协议头。如果在 https://errors.example.com 访问服务器,却将其保留为 http://localhost:8000,那么通知邮件中的所有链接都将指向一个无法解析的主机。当 Nginx 或 Caddy 在其前端终止 TLS(传输层安全)时,请将 BEHIND_HTTPS_PROXY 设置为 true,并转发 X-Forwarded-Proto: https,以便 Bugsink 识别安全请求,并确保其 CSRF 检查使用正确的协议。

厂商公布的吞吐量数据为:在 2 vCPU 和 4 GB 内存的 VPS 上,每秒可处理 18 个事件(每个 50 KB),即每天 150 万个事件。请将此数据视为该工具的性能基准,而非针对你工作负载的保证。但这足以说明其上限远高于单个小型应用的产出。

接下来是许可协议,这是在将其引入技术栈之前必须阅读的部分。Bugsink 采用 PolyForm Shield License 1.0.0 发布。这是“源码可用”(source available)而非开源协议:你可以运行并修改它,但不得将其用于构建与 Bugsink 竞争的产品。对于内部错误追踪器而言,该限制通常不会产生影响。如果你的公司从事开发工具销售,请务必先让相关人员阅读许可协议全文。

错误跟踪和 LLM 可观测性仍然是两类工具

搜索同时提供错误跟踪和大语言模型(LLM)可观测性的工具时,您会看到一些产品声称同时支持两者。但两类数据的结构不同,因此它们一直没有真正合并。错误跟踪工具接收带堆栈跟踪的异常,根据异常计算指纹,再将数千次出现折叠为一个问题,并记录出现次数。LLM 跟踪工具接收包含提示词、响应、token 数量和延迟的 span,但必须保留每一条记录,因为即使两次调用的输入完全相同,它们仍是值得单独查看的事件。

因此,请同时运行这两类工具。将异常发送到错误跟踪工具,并将模型调用发送到专为此类数据构建的系统:用于代理跟踪的自托管 Langfuse覆盖这一部分,自托管 AI 可观测性则从不同角度处理相同的问题。您的应用已经会产生这两类故障。模型调用即使返回看似确定但完全错误的内容,也不会抛出任何异常,因此错误跟踪工具永远不会显示这类问题。

磁盘增长会在之后导致故障

每个错误跟踪器都是写入密集型数据库,并且输入没有上限。应用决定写入量,热代码路径中的一个新 bug 就可能在一夜之间产生一百万个事件。

GlitchTip 发布了一个值得据此规划的数值:每月处理一百万个事件的实例可能需要 30 GB 磁盘空间。保留窗口决定保留这些写入数据中的多少。

Bugsink 则从另一端处理这个问题。它不使用固定配额,而是根据事件数量和事件年龄应用保留算法,并直接公开限制:MAX_RETENTION_EVENT_COUNT 规定已配置的各项目保留数量之和,MAX_RETENTION_PER_PROJECT_EVENT_COUNT 限制每个项目的设置。这些是配置保护措施。当运行 bugsink-manage delete_old_events 或 bugsink-manage vacuum --old-events 时,MAX_EVENT_AGE_DAYS 提供绝对的时间上限。应根据实际存储的事件大小设置事件预算,因为事件数量不是字节限制。

监控服务器上的实际数值:

df -h /
docker system df -v
du -sh /var/lib/docker/volumes/*

docker system df -v 输出每个卷的大小,因此可以看出哪个服务正在增长。如果某个卷每周增加数 GB,而流量没有变化,通常表示保留窗口仍在持续填充,或者按当前事件速率计算,保留内容已经超过分区容量。不要因为保留设置不变就认为不会有数据过期:Sentry 自带的 .env 将 SENTRY_EVENT_RETENTION_DAYS=90 设为默认值,GlitchTip 的 GLITCHTIP_RETENTION_DAYS 默认值为 90。应降低保留窗口以适应磁盘容量,而不是等到分区被填满。

内存问题本质相同,只是表现形式不同。没有限制的服务栈会占用内核提供的全部内存。机器耗尽内存后,OOM killer 会终止 badness score 最高的进程。内核主要根据每个进程的内存使用量计算该分数,然后根据其 oom_score_adj 进行调整。被终止的可能是 Web 服务器,而不是导致问题的错误跟踪器。应为每个服务设置上限:Docker Compose 中的内存限制展示了语法,以及容器达到上限时的行为。容器因达到自身限制而被终止,属于受控故障。主机内存耗尽还会使相邻服务面临风险。

哪种技术栈适合哪种 VPS

  • 1 GB,或 2 GB 且有富余: 使用关闭 Valkey 的一体化模式运行 GlitchTip,或使用 SQLite 运行 Bugsink。对于少量应用,这两种方案在此配置下均可稳定运行。
  • 4 GB: 使用 PostgreSQL 运行 Bugsink,或开启 Valkey 并配置独立 worker 服务的 GlitchTip。在此规格下,无需进行过多调优即可直接运行。
  • 8 GB: 当 Docker 检测到至少 7000 MB 内存时,官方 Sentry(仅错误追踪)配置可通过安装程序的内存检查;该配置同时要求 2 个 CPU 核心。安装前请在 .env 中设置 COMPOSE_PROFILES=errors-only。
  • 16 GB 最低,32 GB 推荐: 官方 Sentry 功能完备的自托管技术栈。仅当你需要轻量级项目未实现的功能时才考虑此方案。请先对照各项目的文档检查具体功能,因为兼容项目已涵盖了常见需求。

无论运行什么,错误追踪器都无法报告自身的故障。请从另一台机器对其进行监控:从另一台机器监控的 Uptime Kuma 会在追踪器宕机时通知你,这正是你的应用开始报错且无人记录的关键时刻。

何时选择托管方案更划算

当数据驻留规则有强制要求,或者事件量大到按量计费成本过高时,自托管错误追踪服务才具有经济效益。除此以外,请务必客观计算成本。Sentry 官方文档要求的完整功能最低配置为 16 GB 内存、4 核 CPU 及高速磁盘,达到此规格的 VPS 并不便宜;仅开启错误追踪功能的最低门槛也需要 2 核 CPU 和 7000 MB Docker 可用内存。此外还需考虑运维成本:每年需多次按顺序处理各种硬性限制,并在每次迁移前执行快照备份。

GlitchTip 和 Bugsink 完全改变了这一成本结构,因为它们仅需 512 MB 到 4 GB 内存的低成本服务器即可运行。其常规 Docker 更新流程仅为拉取镜像并重启,且在进行重大升级前只需核对发布说明和数据库要求。这就是为什么大多数提出此问题的人最终选择了这些兼容项目,而非官方技术栈。他们需要的是错误追踪功能,而不是一个需要时刻看护的分布式数据流水线。

如果你仍在评估哪些服务适合部署在服务器上,值得自托管的服务清单 将错误追踪服务与其它争夺内存资源的候选服务进行了对比。

FAQ

我可以在 2 GB 内存的 VPS 上自托管 Sentry 吗?

不可以。即使是 Sentry 的仅错误(errors-only)配置,也要求 Docker 拥有 2 个 CPU 核心和至少 7000 MB 可用内存;功能完整的官方文档要求至少 4 个 CPU 核心、16 GB 内存加 16 GB 交换空间,以及 20 GB 可用磁盘空间。该技术栈同时运行 Postgres、ClickHouse、Kafka、Valkey 和多个工作进程,安装程序会在内存检查阶段拒绝 2 GB 的服务器。如果容器被强制终止,请检查 dmesg -T | grep -i 'out of memory',该命令会输出被终止进程的名称。对于 2 GB 的 VPS,请使用 GlitchTip(文档要求 512 MB)或 Bugsink(作为单个容器运行在 SQLite 上)。

从 Sentry 切换到 GlitchTip 或 Bugsink 时,需要修改应用程序代码吗?

不需要。两者都接受来自 Sentry 开源 SDK 的事件,因此你可以保留已安装的 SDK,只需修改一个值:DSN,即 SDK 发送事件的目标 URL。如果 DSN 仍硬编码在代码中,请将其移至环境变量,指向新主机,然后触发一个测试异常并观察其是否送达。如果未收到事件,请检查 DSN 中的项目标识符是否与新服务器上存在的项目匹配,并确认防火墙允许应用程序访问该主机和端口。

自托管错误追踪系统需要多少磁盘空间?

这取决于你的事件量和保留周期,而不是工具本身。GlitchTip 建议每月处理一百万个事件的实例预留 30 GB 空间。Bugsink 允许你通过 MAX_RETENTION_EVENT_COUNT 配置项目保留策略,并通过其清理命令应用 MAX_EVENT_AGE_DAYS;磁盘需求仍取决于事件大小和数据库开销。请在第一天检查保留设置:Sentry 和 GlitchTip 默认保留周期均为 90 天,这可能会占用超过磁盘容量的空间。如果追踪系统保留的数据超过磁盘容量,磁盘占用率会增长至 df -h 显示 100%,此时数据摄入将停止,你将丢失最关键的错误信息。

为什么升级自托管 Sentry 总是失败?

因为升级跳过了强制停顿点(hard stop)。Sentry 自托管版本定义了必须依次经过的特定版本,这些版本包含数据库迁移;截至 2026 年 10 月,这些版本为 9.1.2、21.5.0、21.6.3、23.6.2、23.11.0、24.8.0、25.5.1、26.5.0 和 26.7.0。直接从旧版本升级到最新版本会跳过这些迁移,导致数据库架构与代码不匹配,从而导致升级中断。请按顺序检出每个强制停顿点版本,并在每个版本运行 ./install.sh。开始前请对服务器进行快照,并阅读文档中列出的应避免升级的版本,包括 23.7.0、25.9.0 和 25.12.0。

这篇文章对您有帮助吗?

#error-tracking#sentry#glitchtip#observability#自托管