Convex Sentinel

作者 get-convex2cfe645c87f9无许可证63 个星标收录于 2026年10月8日更新于 2026年10月8日仓库6天前更新

Set up Sentinel production error capture in your own Convex deployment.

仅含说明DevOps & Cloud
AI 生成的概览

在用户自己的 Convex 部署中设置 Sentinel 生产错误捕获,包含脱敏与可选的分类处理。

功能
指导在 Convex 项目中安装 @convex-dev/sentinel 组件,并接入客户端 SDK,包括 React 错误边界、全局错误处理与面包屑记录。内容涵盖写入时脱敏、通过 Convex CLI 读取近期错误,以及通过监控器的 prod_error 事件响应新错误。可选的自愈定时任务可对错误分类,并将反复出现的非暂时性错误交给 ai-runner 以提交修复 PR。
适用场景
当 Convex 应用需要将生产错误捕获保留在用户自己的部署内时使用。适合希望记录并分类处理服务端函数失败、客户端 JS/React 崩溃以及 OCC 或规模信号,且不把数据发送给第三方的团队。
运行要求
需要 Convex 项目与部署、@convex-dev/sentinel 组件,以及用于读取错误数据的 Convex CLI。捕获生产错误需要已部署的云应用,而安装可匿名进行。可选的自愈定时任务依赖 ai-runner。该技能不附带脚本,仅为说明文档。
<!-- GENERATED from convex-agents content/capabilities/sentinel.json — do not edit by hand. -->

Capture production errors in your own deployment

Install @convex-dev/sentinel to capture production errors (server function failures, client JS/React crashes, OCC and scale signals) into a table in the user's OWN deployment, redacted at write time, then react to new ones. Data never leaves the user's deployment.

Workflow

  1. Install the component: app.use(sentinel) in convex/convex.config.ts.
  2. Wire the client SDK: a React error boundary plus window.onerror/unhandledrejection and breadcrumbs.
  3. Redaction runs at write time and is on by default (default-deny on secret key names and value patterns).
  4. Read recent errors with the Convex CLI (convex data, run-once-query); react to new ones via the monitor's prod_error event.
  5. Optionally enable the self-healing cron: triage classifies each error and, for recurring non-transient ones, hands it to ai-runner to open a fix PR.

Rules

  • Redaction is mandatory and on by default — never store raw secrets; the agent's reads reach the model provider.
  • Data stays in the user's deployment; never send it to a third party.
  • Sample and cap to control volume and cost.
  • Capturing PROD errors needs a deployed cloud app; install works anonymously.

来源与署名

来源:get-convex/agent-skills位于skills/convex-sentinel提交2cfe645

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架