convex-sentinel
Set up Sentinel production error capture in your own Convex deployment.
42stars
8forks
Updated 8/4/2026
SKILL.md
readonlyread-only
name
convex-sentinel
description
Set up Sentinel production error capture in your own Convex deployment.
<!-- 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
- Install the component:
app.use(sentinel)inconvex/convex.config.ts. - Wire the client SDK: a React error boundary plus
window.onerror/unhandledrejectionand breadcrumbs. - Redaction runs at write time and is on by default (default-deny on secret key names and value patterns).
- Read recent errors with the Convex CLI (
convex data,run-once-query); react to new ones via the monitor'sprod_errorevent. - Optionally enable the self-healing cron:
triageclassifies 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.
