Example — Runbook Content Type
Example title: Database Restore Runbook
Guidance: Use runbook for an ordered operational or incident procedure with verification steps. It answers "what do I do when this breaks?" and should be safe to follow under pressure.
Example content
A database restore runbook for recovering from corruption or accidental deletion. Follow the steps in order, verify the restored data, and document the incident afterward.
Trigger
Production database corruption or accidental deletion.
1. Confirm the incident
- Check application error logs.
- Verify the database is unreachable or corrupt.
- Notify the on-call channel.
2. Stop writes
systemctl stop myapp
3. Restore from backup
pg_restore -d mydb /backups/mydb-latest.dump
4. Verify
psql -d mydb -c "SELECT count(*) FROM users;"
systemctl start myapp
curl -sSf https://example.com/health
5. Post-incident
- Document timeline and root cause.
- Schedule a backup verification test.
- Update this runbook if steps changed.