Sentry is Lucia’s eyes when something breaks. Without this, hosted staging gets dumb fast.
Runbook phase mapping
- Phase 1 — account access, org/project ownership, DSN references
- Phase 7 — error tracking, traces, and deploy visibility
Primary runbook page: 08 - Live Transition Runbook
Why Sentry is in the stack
Once Lucia leaves localhost, you need to know:
- what broke
- where it broke
- when it broke
- how often it broke
- whether deploys caused it
Otherwise you are flying blind with vibes and screenshots. Not ideal.
Lucia role
Sentry should cover:
- Lucia Engine runtime exceptions
- request failures
- deployment regressions
- traces on important paths
- optional Admin/UI errors later
What to instrument first
Must-have first
POST /admin/operator-focus- engine startup failures
- OpenAI call failures
- Supabase connection failures
- Redis connection failures later
- auth/session-related failures that block staging use
Nice later
- Admin/UI error capture
- release tagging
- distributed tracing across services
Setup checklist
Stage 1 — account and project
Stage 2 — engine instrumentation
Stage 3 — admin coverage
Credentials + account reference
Account access
| Item | Value |
|---|
| Account email | |
| Org name | |
| Dashboard URL | |
| Project name | |
| MFA method | |
Keys and references
| Secret / Token | Value or 1Password Reference | Notes | Rotated |
|---|
| DSN | | engine | |
| Auth token | | CI/API use | |
| Org slug | | | |
| Project slug | | | |
Environment variable tracker
| Variable | Value / Reference | Used In |
|---|
SENTRY_DSN | | Engine |
VITE_SENTRY_DSN | | Admin/UI optional |
SENTRY_AUTH_TOKEN | | CI/release tooling |
SENTRY_ENVIRONMENT | | Engine/Admin |
SENTRY_RELEASE | | optional later |
Alerting notes
Alert recipients
Alert thresholds
- critical route failures:
- deploy regression alerts:
- auth failure spikes:
- Redis failure alerts:
Notes / gotchas
- If Lucia is hosted and not instrumented, you are basically debugging by candlelight.
- Sentry is not glamorous. Good. Neither is a fire extinguisher.
Related pages
