convex-sentinel

在你自己的部署中捕获生产环境错误

安装 @convex-dev/sentinel，将生产环境错误（服务端函数失败、客户端 JS/React 崩溃、OCC 和扩缩容信号）捕获到用户自己的部署中的一个表内，在写入时进行脱敏，然后对新错误作出响应。数据绝不会离开用户的部署。

工作流

1. 安装该组件：在 convex/convex.config.ts 中使用 app.use(sentinel)。
2. 接入客户端 SDK：添加 React 错误边界，以及 window.onerror/unhandledrejection 和面包屑。
3. 脱敏在写入时执行，且默认启用（默认拒绝包含机密的键名和匹配机密的值模式）。
4. 使用 Convex CLI（convex data、run-once-query）读取近期错误；通过监控器的 prod_error 事件对新错误作出响应。
5. 可选启用自愈 cron：triage 会对每个错误进行分类，并将反复出现的非瞬时错误交给 ai-runner，以创建修复 PR。

规则

• 脱敏是强制要求，且默认启用——绝不存储未经处理的机密；Agent 读取到的内容会传给模型提供商。
• 数据留在用户的部署中；绝不发送给第三方。
• 对数据进行采样并设置上限，以控制数据量和成本。
• 捕获 PROD 错误需要已部署的云应用；安装可以匿名进行。