| # Flutter postmortem: {Incident Title} |
| |
| Status: {draft|final}<br> |
| Owners: {who drove the incident resolution} |
| |
| ## Summary |
| |
| Description: {brief description of symptoms and root cause}<br> |
| Component: {affected area}<br> |
| Date/time: {YYYY-MM-DD HH:MM}<br> |
| Duration: {time from initial breakage to final resolution}<br> |
| User impact: {who was affected by the incident} |
| |
| ## Timeline (all times in PST/PDT) |
| |
| ### 1900-01-01 |
| |
| 14:44 - something happened<br> |
| 14:45 - next thing happened **<START OF OUTAGE>** |
| |
| ### 1900-01-02 |
| |
| 09:12 - another thing happened **<END OF OUTAGE>** |
| |
| ## Impact |
| |
| {summarize the problems that the outage caused} |
| |
| ## Root causes |
| |
| {without blame, describe the root cause of the outage} |
| |
| ## Lessons learned |
| |
| ### What worked |
| |
| {list things where things worked as expected in a positive manner} |
| |
| ### Where we got lucky |
| |
| {list things that mitigated this incident but not because of our foresight} |
| |
| ### What didn't work |
| |
| {list things that failed, with github issues from the action items section} |
| |
| ## Action items |
| |
| {each item here should have an owner} |
| |
| ### Prevention |
| |
| {link to github issues for things that would have prevented this failure from happening in the first place, such as input validation, pinning dependencies, etc} |
| |
| ### Detection |
| |
| {link to github issues for things that would have detected this failure before it became An Incident, such as better testing, monitoring, etc} |
| |
| ### Mitigation |
| |
| {link to github issues for things that would have made this failure less serious, such as graceful degradation, better exception handling, etc} |
| |
| ### Process |
| |
| {link to github issues for things that would have helped us resolve this failure faster, such as documented processes and protocols, etc} |
| |
| ### Fixes |
| |
| {link to github issues or PRs/commits for the actual fixes that were necessary to resolve this incident} |
| |
| ## Appendix |
| |
| {any other useful information, such as relevant chat logs} |