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 從公開儲存庫中收錄這些內容。

檢舉或申請下架