Postmortem

Postmortem

An exercise to learn from any incident that impacts the product or users. In the SRE community, this exercise is called an incident retrospective.

Phases

Delivery

Suggested Time

1 hour

Participants

Core delivery team, stakeholder, and support team


Why do it?

Postmortems help to reduce the recurrence of negative incidents

When to do it?

  • When the team agrees that there is something to learn about the incident or near miss
  • During the incident or soon after it is resolved, as long as the session would not interfere with resolving the incident
  • Stakeholders or another team (e.g. support team) has asked for a postmortem session

What supplies are needed?

  • Whiteboard or digital version like Miro
  • Sticky notes
  • Painter’s tape
  • Sharpies

How to Use this Method

First, let’s define an Incident:

  • An event in the live product that interrupts the user’s interaction with the product
  • An unexpected negative event that has a high impact on your development process
  • An error budget violation

Sample Agenda & Prompts

  1. Prior to the session, collect as much information about the incident as you can. For example, you might send a survey to relevant teams requesting information. If teams took notes about the incident while it was in progress, collect these as well.

    Moreover, it will be helpful to create a timeline prior to the session and validate it during the postmortem session.

    Example of timeline:

    Postmortem Timeline

    Make sure to invite the right people for the postmortem session. For example:

    • Core team: Product Manager(s), Engineer(s), Designer(s)
    • Relevant party, anyone who is the key role and involved in the incident. For example:
      • Member of platform team
      • Member of security team
  2. Explain the goal of the postmortem (5 minutes)

    You might say something like:

    “What caused the recent incident? How did we fix it? Additionally, we want to define action items to avoid this in the future and document it in our postmortem document. We are not looking to find someone to blame.”

    Tip: Embrace blameless culture because you want to identify what happened and how to avoid it in the future. Make sure you provide psychological safety for each team member.

  3. Present the incident timeline (5 minutes)

    Show the incident timeline and confirm it with the team.

  4. Brainstorming Postmortem Topic (5 minutes)

    Ask team to write on post-it or digital workspace:

    • What went wrong - What caused the recent incident?
    • What went well - What did we do that worked well to fix the incident?
    • Where we got lucky - Are there any events/things that helped us out?
  5. Quick Topic Clustering (5 minutes)

    Ask the team to cluster the post-its based on similar topics.

  6. Discuss each cluster (20 minutes)

    Allow enough time for each cluster to be discussed. If any particular clusters need additional time, consider a follow-up session about that specific topic.

    Additionally, for clusters in the “what went wrong” column, ask “Why did this happen?” and “How can we reduce the impact if it happens again?”

    Tip: consider using “five whys” method. Again, be sure to focus on root causes that are due to the process, not individual blame.

  7. Discuss the action items (15 minutes)

    Discuss with the team what actions we can take to solve the incident and avoid it in the future. Define the owner(s) of these actions.

  8. Agree on the postmortem owner(s) (4 minutes)

    Decide as a team the postmortem owner, whose responsibilities are to:

    • Create a postmortem document for future reference that contains:
      • Overview of the incident
      • Action items to resolve the incident
      • Root cause analysis
      • Learnings and next steps to avoid the incident happening in the future
    • Communicate with stakeholders regarding the status of the postmortem
    • Plan review meeting to make sure all action items in the postmortem meeting is done
  9. Schedule the follow up (1 min)

    Agree with the team for a follow up postmortem session to review the actions. The incident should not be closed until the team completes all postmortem actions.

Success/Expected Outcomes

At the end of this exercise, the team will have a clear alignment of what the incident was and how it happened. Moreover, the team will have a set of plans to prevent or reduce the impact of the incident’s recurrence.

Facilitator Notes & Tips

Examples of postmortem documents:

Atlassian Incident management

Google Postmortem culture

Book: Life of a production system incident (coming soon!)