Skip to main content

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.