用途:在用户自己的 Convex 部署中搭建生产错误捕获。它能记录服务端函数失败、客户端 JS/React 崩溃,以及 OCC 与规模信号,写入用户自有部署中的表,写入时即进行脱敏,并可对新错误做出反应。数据不会离开用户部署。
主要能力:安装 @convex-dev/sentinel 组件;客户端 SDK 接入,包含 React 错误边界、window.onerror/unhandledrejection 与面包屑;脱敏在写入时运行且默认开启,默认拒绝密钥类键名与值模式;可通过 Convex CLI 读取近期错误(convex data、run-once-query),并通过 monitor 的 prod_error 事件响应新错误。可选启用自愈 cron:对每个错误分类,对反复出现的非瞬时错误交给 ai-runner 打开修复 PR。
使用方式:在 convex/convex.config.ts 中写入 app.use(sentinel) 安装组件;接入客户端 SDK;按需用 CLI 查询错误或监听事件。
适用场景:需要在自己的 Convex 部署内观测并响应生产错误的项目,含服务端与客户端崩溃。
限制与规则:脱敏为强制且默认开启,绝不能存储原始密钥,代理的读取会到达模型提供方;数据留在用户部署中,不得发送给第三方;需采样与限流以控制数据量与成本;捕获生产错误需要已部署上线的云应用,安装本身可匿名进行。其他平台、收费与效果信息暂未提供。