Course contentsShow
← System Design
Lesson 1352 of 1,91933. Reliability Engineering FoundationsFree lesson

Postmortem Structure and Action Items

Timeline, root cause, contributing factors, impact metrics, detection/response analysis, and concrete follow-up tasks with owners.

Postmortem Structure and Action Items

What you'll learn: How to organize a postmortem document and define concrete follow-up tasks that turn incident learnings into reliability improvements.

The Core Structure

A well-structured postmortem transforms chaos into clarity. Think of it like a well-organized crime scene investigation report—it should tell a clear story and lead to actionable prevention.

Essential sections:

  1. Timeline: Chronological sequence of what happened, when, and who did what. Timestamps matter.
  2. Root Cause: The underlying reason the incident occurred (not just symptoms).
  3. Contributing Factors: Additional conditions that enabled or worsened the incident.
  4. Impact Metrics: Quantifiable damage—error rate, affected users, revenue loss, MTTR.
  5. Detection/Response Analysis: How was it detected? How long until response? What worked or didn't?

From Analysis to Action

The magic happens in the Action Items section. These aren't vague wishes—they're concrete tasks:

  • Specific: "Add timeout to database query X" not "improve monitoring"
  • Owned: Every action has a name attached
  • Tracked: Added to your project management system with deadlines
  • Prioritized: Critical fixes first, nice-to-haves later

Example action items:

  • "Add circuit breaker to payment service (Owner: Sarah, Due: 2 weeks)"
  • "Document rollback procedure for DB migrations (Owner: James, Due: 1 week)"
  • "Set up canary deployment for API changes (Owner: Platform team, Due: Q2)"

The detection/response analysis often reveals process gaps: "We didn't have an on-call runbook" becomes "Create runbook for X scenario."

Key Takeaway: A postmortem without tracked, owned action items is just storytelling—the structure turns incidents into systematic reliability improvements that prevent recurrence.