Google’s postmortem template uses a Shakespearean sonnet example to bring it to life. Significant facts are outlined from the get-go, including date, authors, status, summary, impact, and root causes. The trigger, resolution, and detection are all defined on the first page, giving readers a big-picture understanding of the project in minutes.
The action items are broken down into a clear, concise table. The action type, owner, and bug are confirmed, ensuring everyone knows who is in charge of what.
The report concludes with a comprehensive section on lessons learned. Unpacking what went well, what went wrong, and where we got lucky is essential. The entire incident culminates in a step-by-step timeline, including timestamps and essential updates. Any supporting information is noted for future reference.
Postmortem Example
Date: 2015-10-21
Authors: jennifer, martym, agoogler
Status: Complete, action items in progress
Summary: Shakespeare Search down for 66 minutes during period of very high interest in Shakespeare due to discovery of a new sonnet.
Impact: Estimated 1.21B queries lost, no revenue impact.
Root Causes: Cascading failure due to combination of exceptionally high load and a resource leak when searches failed due to terms not being in the Shakespeare corpus. The newly discovered sonnet used a word that had never before appeared in one of Shakespeare’s works, which happened to be the term users searched for. Under normal circumstances, the rate of task failures due to resource leaks is low enough to be unnoticed.
Trigger: Latent bug triggered by sudden increase in traffic.
Resolution: Directed traffic to sacrificial cluster and added 10x capacity to mitigate cascading failure. Updated index deployed, resolving interaction with latent bug. Maintaining extra capacity until surge in public interest in new sonnet passes. Resource leak identified and fix deployed.
Detection: Borgmon detected high level of HTTP 500s and paged on-call.
Action Items:
2015-10-21 (all times UTC)
ManyHttp500s
from all clusters#shakespeare
, names jennifer incident commanderGoogle’s postmortem template uses a Shakespearean sonnet example to bring it to life. Significant facts are outlined from the get-go, including date, authors, status, summary, impact, and root causes. The trigger, resolution, and detection are all defined on the first page, giving readers a big-picture understanding of the project in minutes.
The action items are broken down into a clear, concise table. The action type, owner, and bug are confirmed, ensuring everyone knows who is in charge of what.
The report concludes with a comprehensive section on lessons learned. Unpacking what went well, what went wrong, and where we got lucky is essential. The entire incident culminates in a step-by-step timeline, including timestamps and essential updates. Any supporting information is noted for future reference.