convex-sentinel

Original：🇺🇸 English

Translated

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

236installs

Sourceget-convex/agent-skills

Added on2026-08-02

NPX Install

npx skill4agent add get-convex/agent-skills convex-sentinel

SKILL.md Content

View Translation Comparison →

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)

in

convex/convex.config.ts

.

Wire the client SDK: a React error boundary plus
```
window.onerror
```
/
```
unhandledrejection
```
and 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's
```
prod_error
```
event.
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 (Tier 2); install works anonymously.