Skip to content

docs: application error detection (Sentry-lite)#40

Merged
acoshift merged 1 commit into
mainfrom
error-detection
Jun 21, 2026
Merged

docs: application error detection (Sentry-lite)#40
acoshift merged 1 commit into
mainfrom
error-detection

Conversation

@acoshift

Copy link
Copy Markdown
Member

PR 7/7 of error detection (SPEC-error-detection.md) — the documentation page for the feature.

What this documents

deploys.app automatically mines a deployment's durable logs for application-level stack traces (Go panics; Java/Python/Node/Ruby exceptions; a generic fallback) and groups identical traces into deduplicated issues with an occurrence count, first/last-seen, a representative stack, and recent occurrences — with an open → resolved → reopened/regressed (plus muted) triage lifecycle. Detection runs server-side from the captured logs, so it lags live output by roughly a minute, and only stack traces become issues (lone ERROR lines stay in the logs).

Pages added / changed

  • content/deployments/error-detection.md (new, weight 9 — right after Monitoring) — the feature page:
    • What it is, and where it sits vs deployment.health (infra) and deployment.status (pod).
    • How it works (server-side, log-bucket locations only, ~1-minute lag, fingerprint dedup).
    • The triage lifecycle (open / resolved / reopened-on-regression / muted).
    • The Console Errors tab (list + status filter + issue detail with the stack and resolve/mute/reopen).
    • Notifications: the deployment.error change event delivered to webhook/Discord channels; subscribe to deployment.error or deployment.*. Message carries only the exception type + reason, never the stack (secret-safe).
    • The API: deployment.errors, deployment.errorGet, deployment.errorUpdate (params + response), all gated by deployment.logs; the six kinds.
    • A light CLI (deploys deployment errors) and MCP mention.
    • ~30-day retention, matching log history.
  • content/api/conventions.md — registers the three new actions in the Deployments function catalog.
  • content/automation/cli.md — adds errors to the deployment namespace actions.
  • content/automation/mcp.md — short pointer to deployment.errors / errorGet in the diagnose-a-failing-deploy recipe.
  • content/deployments/monitoring.md — cross-link from the Logs section to the new page.

Verification

  • hugo --minify builds clean (56 pages, no errors/warnings).
  • All internal links and heading anchors resolve; the page registers in the Deployments sidebar in weight order.
  • /scrutinize run: every API field name, parameter, status value, permission, event name, lag figure, and retention window checked against the contract and the SPEC.

🤖 Generated with Claude Code

https://claude.ai/code/session_011d4bVuGLnCbcJD9ZvastPH

Add a Deployments-section page documenting the new application error
detection feature: deploys.app mines deployment logs for stack traces,
groups identical traces into deduplicated issues with counts, first/last
seen, a representative stack, and an open/resolved/reopened/muted triage
lifecycle.

Covers the Console Errors tab, the deployment.error notification event,
the deployment.errors/errorGet/errorUpdate API (gated by deployment.logs),
the six kinds, and ~30-day retention. Registers the new actions in the API
catalog, adds the deployment errors CLI verb and a light MCP mention, and
cross-links from the monitoring page.

PR 7/7 of error detection (SPEC-error-detection.md).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011d4bVuGLnCbcJD9ZvastPH
@deploys-app deploys-app Bot temporarily deployed to pr-40 June 21, 2026 12:42 Destroyed
@deploys-app

deploys-app Bot commented Jun 21, 2026

Copy link
Copy Markdown

Preview deleted (PR closed).

@acoshift acoshift merged commit 71fe13e into main Jun 21, 2026
1 check passed
@acoshift acoshift deleted the error-detection branch June 21, 2026 12:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant