Skip to main content

Incident Response Playbook

Severity Classification​

SevDefinitionResponse TimeExamples
SEV-1Production down, data loss risk15 min ack, all-handsAll regions 5xx, DB corruption, audit-log chain break
SEV-2Major degradation1 hour ack, on-call + backupSingle region down, latency 5x, model provider unreachable
SEV-3Minor degradation4 hours ack, on-callSingle model failing, dashboard down, slow queries
SEV-4Cosmetic / non-urgentNext business dayTypo, minor UI bug, documentation error

Response Steps​

SEV-1 / SEV-2​

  1. Declare: On-call engineer declares severity and creates war-room (#incident-YYYYMMDD-HH).
  2. Page: PagerDuty auto-pages primary + secondary. Escalate to manager after 30 min no-ack.
  3. Communicate: Post initial update on status page within 30 minutes. Notify SOC 2 customers within 72 hours if data breach.
  4. Mitigate: Apply known fix or rollback (helm rollback yabanin). If DB corruption, trigger DR drill.
  5. Resolve: Restore service to normal. Document resolution steps in war-room.
  6. Post-mortem: Within 5 business days (blameless). Publish findings to all-staff.

SEV-3 / SEV-4​

  1. Triage in on-call queue during business hours.
  2. Assign owner, set target resolution time.
  3. Resolve and close ticket. Document root cause for SEV-3.

Communication Templates​

Initial Incident Update​

[INCIDENT] Yabanin Platform — Sev <X> — <brief description>
Time: <HH:MM UTC>
Impact: <what's affected>
Status: Investigation ongoing
Next update: <30 min from now>

Resolution Notice​

[RESOLVED] Yabanin Platform — Sev <X> — <brief description>
Duration: <start> to <end> (<total time>)
Root cause: <summary>
Preventive action: <what's being done>
Post-mortem: <link or ETA>
  • docs/runbooks/sev-classification.md — severity decision matrix
  • docs/runbooks/post-mortem-template.md — blameless post-mortem format
  • Internal SOC 2 incident-response policy (local private worksheets, not in this tree)