
Rustrak 发布:兼容 Sentry SDK 的自托管错误追踪工具
来源标题:Rustrak, a self-hosted error tracker for your existing Sentry SDKs
Rustrak 是一款自托管错误追踪工具,兼容 Sentry 协议,现有 Sentry SDK 只需改一个字符串即可接入,无需安装新代理或重写代码。它还支持日志、事务、发布健康和 AI-agent 追踪,默认以单进程配合 SQLite 运行,整个安装只需一个 compose 文件。其数据接收采用两阶段设计,端点先落盘并返回 200,再由后台任务写库,避免流量高峰导致超时。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
文档 · 快速开始 · 路线图 · 更新日志 · 报告 bug
Rustrak 是一个自托管的错误跟踪工具,同时也接收日志、事务、发布健康状况和 AI agent 追踪。 它说的就是 Sentry 协议本身,而不是一个仿制品,所以你现有的 SDK 只需改一个字符串就能指向 Rustrak。不用安装新的 agent,不用替换第三方库,也不用重写代码。它以单进程方式运行,默认使用 SQLite,也就是说整个安装就是一个 compose 文件,不需要预先准备任何东西。
错误跟踪通常有两种选择:要么是随你最忙的一天而水涨船高的 SaaS 账单,要么是需要独占一台机器的自托管方案。Rustrak 是第三种选择:同样的协议,跑在你已有的硬件上。
做到这一点主要靠两个设计决策。第一,仪表盘是服务器直接分发的静态文件,所以一个小进程同时响应 API 和 UI,而一个不包含仪表盘构建出来的镜像本身也是完整的产品。第二,数据接收分为两个阶段。接口先解析 envelope,写入磁盘并返回 200;之后由派生出的任务完成数据库操作。接收事件从不等待数据库,这正是避免流量高峰变成你应用内超时的原因。在一台 4 核机器上搭配 SQLite,2 万个事件的突发流量可以以约每秒 5k 事件的速度被接收,服务器内存峰值低于 60 MB。
没有按事件计费,没有你并未要求的采样,也没有需要向任何人解释的席位费用。
SQLite 是默认选项,所以这就是全部安装内容。没有数据库需要准备,也没有 broker 需要运行。
这是仓库中的 docker-compose.yml:
services: server: image: rustrak/rustrak-server:latest ports: ["8080:8080"] volumes: [rustrak_data:/data] environment: - SESSION_SECRET_KEY=${SESSION_SECRET_KEY} - CREATE_SUPERUSER=${CREATE_SUPERUSER} restart: unless-stopped volumes: rustrak_data:
export SESSION_SECRET_KEY=$(openssl rand -hex 32) export CREATE_SUPERUSER=admin@example.com:changeme123 docker compose up -d
打开 http://localhost:8080,用这些凭据登录。一个容器同时响应仪表盘和 API,所以没有第二个端口,也不需要告诉一半另一半的地址。想让仪表盘和数据跑在不同主机上?rustrak/rustrak-ui 是同一个仪表盘放在 nginx 后面;参见生产环境指南。
要大规摸运行?docker-compose.postgres.yml 会在一个 PostgreSQL 服务旁边运行 :postgres 镜像。安装指南里写了两套配置和生产环境的注意事项。
Rustrak 接受标准的 Sentry envelope,所以迁移是一次配置变更,而不是一个项目。创建一个项目,复制它的 DSN,改一行即可。你的 SDK 永远不会知道自己在和别的东西通信。
Python
import sentry_sdk sentry_sdk.init(dsn="http://<key>@localhost:8080/<project_id>")
// JavaScript import * as Sentry from "@sentry/browser"; Sentry.init({ dsn: "http://<key>@localhost:8080/<project_id>" });
// Go sentry.Init(sentry.ClientOptions{Dsn: "http://<key>@localhost:8080/<project_id>"})
任何 Sentry SDK 都能用,任何语言都行。如果你已经在向 Sentry 发送数据,可以把第二个 DSN 指向 Rustrak,在正式切换前对比两者。
错误 事件按确定性指纹归组为 issue:如果 SDK 发送了指纹就用它,否则用异常类型、消息第一行加上事务。相同的输入,每次得到相同的分组,所以一次部署后 issue 不会裂成两个。
在列表里你可以批量分类、按状态过滤,不打开任何东西就能看到每个 issue 的 24 小时趋势。上传 source map 后,压缩过的栈帧就能还原到你实际写的那一行。
打开 SDK 的 AI 集成,agent 运行会出现在单独的页面上:随时间的运行次数、耗时百分位、按调用次数和按 token 数排名的热门模型、热门工具,以及每次 trace 中每个 LLM 调用、工具调用和交接的有序瀑布图。Rustrak 读取 Sentry 的 Spans Protocol v2,也就是真正的 SDK 用于 AI span 的批量格式,已通过 @sentry/node 配合 Vercel AI SDK 验证。它也接受没有父事务的独立 OTel 风格 span。当一个 agent 在运行中途交接给另一个 agent 时,trace 会列出涉及的所有 agent,而不只是第一个。
服务端无需任何设置。Sentry.init 里加一个集成就是全部改动:
import * as Sentry from '@sentry/node'; Sentry.init({ dsn: 'http://<key>@localhost:8080/<project_id>', integrations: [Sentry.vercelAIIntegration()], });
而且我们刻意没有花费组件。按模型的定价过时得比我们发布的速度还快,所以 Rustrak 只报告精确的 token 数量,乘法留给你自己做。
事务和 span 经过处理器流水线进入性能仪表盘,按 p95 排名。延迟按阈值着色,而不是留作原始数字:低于一秒为绿色,低于三秒为琥珀色,超过为红色。需要关注的那一行,就是看起来不对的那一行。
打开一个事务可以看它的 span 瀑布图和各项测量值。
错误告诉你哪里坏了。日志告诉你没坏的时候应用在做什么。Rustrak 把结构化日志作为一等事件类型存储在同一个 envelope 接口上,包含从 trace 到 fatal 六个级别,有独立的过滤器,每行的属性保留其类型。
在活跃 span 内发出的日志会带上 trace_id,因此能链接回它来自的那个请求。
日志在 Sentry SDK 中默认关闭。选择开启一次,然后使用 logger:
Sentry.init({ dsn: 'http://<key>@localhost:8080/<project_id>', enableLogs: true, });
Sentry.logger.info('User signed up', { userId: 4172, plan: 'pro' });
发布健康状况 会话以完全兼容 Sentry SDK 的方式被跟踪并按发布版本聚合,这就把“这次部署比上次更糟吗”变成了两个数字:无崩溃会话率和无崩溃用户率。
两者都分级显示,而不是平淡地打印出来:99% 及以上为绿色,95% 为琥珀色,更低为红色。一个 96% 的发布并不算好,也不该看起来像好的一样。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。