SuperAPI AI 工具集

convex-sentinel

部署与运维

查看项目

更新于 10-16 17:04

技能介绍

用途 convex-sentinel 用于在用户自己的 Convex 部署中搭建 Sentinel 生产错误捕获能力,把生产环境中的错误收集到用户自有部署的表中,并能对新错误做出反应,数据不离开用户部署。

主要能力 可捕获的生产错误包括:服务器函数失败、客户端 JS/React 崩溃、OCC 与规模信号。错误写入用户自有部署中的一张表,写入时进行脱敏,默认开启脱敏(对密钥类名称和值模式采用默认拒绝策略)。可以读取最近错误,也可以对新错误进行响应。可选启用自愈 cron:对错误进行分类,针对反复出现的非瞬时错误,交由 ai-runner 开启修复 PR。

使用方式

  1. 安装组件:在 convex/convex.config.ts 中写入 app.use(sentinel)。
  2. 接线客户端 SDK:使用 React 错误边界,加上 window.onerror/unhandledrejection 与 breadcrumbs。
  3. 脱敏在写入时运行且默认开启(对密钥类名称和值模式默认拒绝)。
  4. 使用 Convex CLI(convex data、run-once-query)读取最近错误;通过 monitor 的 prod_error 事件对新错误做出反应。
  5. 可选启用自愈 cron:triage 对每个错误分类,对反复出现的非瞬时错误交由 ai-runner 开启修复 PR。

适用场景 需要在自有 Convex 部署中捕获生产错误并进行响应,同时要求数据保留在自己部署内、写入时脱敏的团队或项目。捕获生产错误需要已部署的云应用;安装可匿名进行。

限制与规则 脱敏是强制且默认开启的,绝不存储原始密钥,因为代理读取会到达模型提供方。数据保留在用户部署中,绝不发送给第三方。需要采样与设上限以控制量与成本。