Alyson Docs

Operations — Overview

Runbooks, monitoring, alerting.

Owner: @adminStatus: wipLast verified: 5/18/2026

Stub. This section will hold runbooks (/runbooks), monitoring docs, and alerting configuration.

Runbooks

Each runbook is its own page in docs/40-operations/runbooks/. Use templates/runbook.md. Optimize for speed-of-reading at 3 a.m.

To be added:

  • Backend deployment runbook
  • Frontend deployment runbook
  • Experiment Manager — workflow stuck / retry runbook
  • Postgres failover runbook
  • Vercel rollback runbook

Monitoring

What we monitor, where alerts fire, how to access dashboards. To be documented per service.

Alerting

Routing rules — who gets paged for what, escalation paths.