# zicula-error-tracking-kit — free sample

Two real files from the full kit (24 files), each **trimmed to taste** — enough
to judge the quality, not enough to run the whole operation:

- `dsn-setup-sample.md` — the complete introduction and the full JavaScript /
  TypeScript section from `guides/DSN-SETUP.md`: the Sentry-SDK-compatibility
  explanation, the `SENTRY_DSN` env convention, the `send-test-event.sh` proof
  pipe, `instrument.ts` with the AbortError filter, the Next.js App Router
  hook and the browser-bundle DSN injection. The full file adds Python
  (Django/Flask/FastAPI), PHP (Laravel/Symfony), Go (with the
  flush-before-exit detail), and the §5 wiring checklist (secrets, per-stage
  environments, one project per service, PII scrubbing).
- `alerts-sample.md` — the full "how GlitchTip alerting works" model and the
  complete Telegram section from `guides/ALERTS.md`: BotFather setup, finding
  your chat id, the smoke-test-before-wiring rule, the alert rule, and the
  drill that proves the whole chain with `send-test-event.sh`. The full file
  adds Slack (and Discord), the email fallback, the tuning table that keeps
  alerts loud but never noisy, the honest uptime-monitoring note, and the
  on-call sanity checklist.

What the full kit adds (the other 22 files):

- **The installer:** `install.sh` — one command from a fresh Ubuntu 24.04 /
  Debian 12 VPS to HTTPS GlitchTip: installs Docker if missing, generates
  secrets (never printed, chmod 600), wires Caddy TLS, waits for the app to
  answer; idempotent re-runs keep your existing `.env`.
- **The stack:** `compose/compose.yml` — GlitchTip 6 (web + worker + one-shot
  migrate), PostgreSQL 18 with least-privilege roles via `db-init`, Valkey 9,
  Caddy 2 with automatic HTTPS and security headers; `Caddyfile` and a fully
  documented `.env.example`.
- **`SETUP.md`** — the 6-chapter install SOP (DNS → install → lock
  registration → wire apps → ops baseline → go-live) that tells you which
  guide to open when.
- **Operations guides:** `BACKUP-RESTORE.md` (nightly pg_dump, off-box restic →
  R2, quarterly restore drill), `UPDATES.md` (safe update order, major-version
  pitfalls), `MIGRATION-SENTRY.md` (parallel-run plan, honest feature-gap
  pass), `SIZING.md` (512 MB → 4 GB picker, 12-month cost math vs Sentry).
- **Tools:** `backup.sh` (retention + integrity verification), `update.sh`
  (verified backup + health checks), `send-test-event.sh`, and
  `lock-registration.sh` — slam the door after your first account exists.
- **`README-buyer.md` + `MANIFEST.md` + `LICENSE.txt`** — quickstart, the
  file-by-file map, and the single-buyer commercial license.
- **`screenshots/`** — rendered previews of five core documents (the 8-step
  quickstart, the SETUP SOP, DSN wiring, backups, alerts).

One-time purchase $42 · free updates for v1.x · 30-day full refund.