Skills

Skill 29 of 33

Convex Sentinel

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

1 minute · 190 words · 3 sections

Install

$ npx skills add convex/agent-skills --skill convex-sentinel

$ npx skills add convex/agent-skills

The first command installs just this skill, by the name in its SKILL.md; the second installs the whole repository.

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; install works anonymously.

Colophon for this issue

Colophon

How this issue was made

Source

github.com/convex/agent-skills, branch main, last pushed 29 October 2026.

Licence

Apache-2.0 — the text of every skill is reproduced unmodified, frontmatter included, under the upstream licence.

Discovery

33 skills found by walking the repository tree for SKILL.md, not by matching a directory convention. One layout observed: skills/*/SKILL.md.

Issue colours

Resolved from a curated brand profile — hue 80°, chroma 0.160. Two accent tones are generated per issue and each is proven against its own ground before it ships: a single accent that passes AA on both light and dark paper is arithmetically impossible.

Heading repairs

1 repair applied to this skill so the document has one h1 and no skipped levels:

Shifted “3 headings” from h1 to h2 so the skill title is the only h1.

Spec compliance

Every skill satisfies the Agent Skills specification’s frontmatter rules.

Images

Images inside a skill come from the upstream repository. Where the author gave no alternative text we mark the image decorative rather than inventing a description — a plausible caption we made up is worse than none for the reader who depends on it.

Signal

Install counts come from skills.sh. They measure downloads, not quality, and an unranked repository is not an unread one.

Agent surfaces

The whole issue is available as one markdown document at /convex/agent-skills.md, and each skill at its own .md URL.

Publication

Set by Skills Docs from the source repository. Body text is Literata at the reader’s chosen size and measure; code is Geist Mono. Nothing on this page was written by us except this paragraph.

Capture production errors in your own deployment

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.

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.