Skip to content

Free Engineering Template

Free Postmortem Report

Incident analysis with root cause and prevention

Incident Summary Timeline Root Cause Impact What Went Well What Went Wrong Action Items

Postmortem Report

Use this template to incident analysis with root cause and prevention.

Template Metadata

Field Details
Category Engineering
Owner [Team or owner]
Version [Version number]
Effective Date [Date]
Review Cycle [Monthly / Quarterly / Annual / Event-based]
Status [Draft / In Review / Approved]

Incident Summary

Date, duration, severity, and one-line summary.

Item Details Owner Status
[Item or requirement] [Describe the relevant detail, evidence, or decision] [Owner] [Open / Complete]
[Item or requirement] [Describe the relevant detail, evidence, or decision] [Owner] [Open / Complete]

Notes

[Add context, assumptions, exceptions, evidence links, screenshots, calculations, or reviewer comments.]

Timeline

Chronological events from detection to resolution.

Item Details Owner Status
[Item or requirement] [Describe the relevant detail, evidence, or decision] [Owner] [Open / Complete]
[Item or requirement] [Describe the relevant detail, evidence, or decision] [Owner] [Open / Complete]

Notes

[Add context, assumptions, exceptions, evidence links, screenshots, calculations, or reviewer comments.]

Root Cause

Technical root cause analysis.

Item Details Owner Status
[Item or requirement] [Describe the relevant detail, evidence, or decision] [Owner] [Open / Complete]
[Item or requirement] [Describe the relevant detail, evidence, or decision] [Owner] [Open / Complete]

Notes

[Add context, assumptions, exceptions, evidence links, screenshots, calculations, or reviewer comments.]

Impact

Customer impact, data impact, and business impact.

Item Details Owner Status
[Item or requirement] [Describe the relevant detail, evidence, or decision] [Owner] [Open / Complete]
[Item or requirement] [Describe the relevant detail, evidence, or decision] [Owner] [Open / Complete]

Notes

[Add context, assumptions, exceptions, evidence links, screenshots, calculations, or reviewer comments.]

What Went Well

Effective responses and systems.

Item Details Owner Status
[Item or requirement] [Describe the relevant detail, evidence, or decision] [Owner] [Open / Complete]
[Item or requirement] [Describe the relevant detail, evidence, or decision] [Owner] [Open / Complete]

Notes

[Add context, assumptions, exceptions, evidence links, screenshots, calculations, or reviewer comments.]

What Went Wrong

Failures and gaps identified.

Item Details Owner Status
[Item or requirement] [Describe the relevant detail, evidence, or decision] [Owner] [Open / Complete]
[Item or requirement] [Describe the relevant detail, evidence, or decision] [Owner] [Open / Complete]

Notes

[Add context, assumptions, exceptions, evidence links, screenshots, calculations, or reviewer comments.]

Action Items

Specific, assigned, and deadline-bound action items. Be factual and blameless. Focus on systems, not individuals.

Item Details Owner Status
[Item or requirement] [Describe the relevant detail, evidence, or decision] [Owner] [Open / Complete]
[Item or requirement] [Describe the relevant detail, evidence, or decision] [Owner] [Open / Complete]

Notes

[Add context, assumptions, exceptions, evidence links, screenshots, calculations, or reviewer comments.]

Review and Signoff

Document review conclusions, approvals, unresolved items, and next review date.

Role Name Date Notes
Preparer [Name] [Date] [Notes]
Reviewer [Name] [Date] [Notes]
Approver [Name] [Date] [Notes]

Template Structure

What the Postmortem Report Includes

Use this engineering template as a starting point, then customize each section to match your internal workflow, evidence, and signoff needs.

1

Incident Summary

Date, duration, severity, and one-line summary.

2

Timeline

Chronological events from detection to resolution.

3

Root Cause

Technical root cause analysis.

4

Impact

Customer impact, data impact, and business impact.

5

What Went Well

Effective responses and systems.

6

What Went Wrong

Failures and gaps identified.

7

Action Items

Specific, assigned, and deadline-bound action items. Be factual and blameless. Focus on systems, not individuals.

Recommended Structure

Write a blameless Postmortem Report. Structure with:

Incident Summary

Date, duration, severity, and one-line summary.

Timeline

Chronological events from detection to resolution.

Root Cause

Technical root cause analysis.

Impact

Customer impact, data impact, and business impact.

What Went Well

Effective responses and systems.

What Went Wrong

Failures and gaps identified.

Action Items

Specific, assigned, and deadline-bound action items.

Be factual and blameless. Focus on systems, not individuals.

Example Filled Template

Postmortem: Cart Service Outage — 2026-02-03

Severity: SEV-1 | Duration: 47 minutes | Incident Commander: M. Rodriguez

Incident Summary

On February 3, 2026, the cart service was unavailable for 47 minutes (14:23–15:10 UTC), preventing all customers from adding items to cart or completing checkout. Root cause was a database connection pool exhaustion caused by a slow query introduced in the 14:00 deployment.

Timeline (UTC)

Time Event
14:00 Deploy v2.41.0 to production (includes new product recommendation query)
14:23 Alerts fire: cart-service error rate > 5%, p99 latency > 10s
14:25 On-call SRE acknowledges alert, begins investigation
14:32 Identified: all DB connections in "active" state, 0 available
14:35 Decision to rollback v2.41.0
14:42 Rollback deployed (v2.40.3)
14:48 DB connections recovering, error rate dropping
15:10 All metrics back to normal, incident resolved

Root Cause

The v2.41.0 release included a new product recommendation query that performed a sequential scan on the order_items table (48M rows) instead of using the compound index. Under load, each query held a DB connection for ~30 seconds instead of ~50ms, exhausting the 20-connection pool within minutes.

Impact

  • Customers affected: ~12,400 (all users attempting cart operations)
  • Revenue impact: Estimated $34,000 in delayed/lost orders
  • Data loss: None

What Went Well

  • Alerts fired within 3 minutes of impact
  • Rollback was clean and fast (7 minutes from decision to deploy)
  • Customer communication posted within 15 minutes

What Went Wrong

  • New query was not load-tested before production
  • No query performance regression tests in CI
  • Connection pool had no per-query timeout

Action Items

# Action Owner Deadline
1 Add query performance tests to CI pipeline J. Park 2026-02-10
2 Set per-query timeout to 5s on connection pool M. Lee 2026-02-05
3 Increase connection pool to 50 with circuit breaker M. Lee 2026-02-12
4 Add slow query alert (>1s) to monitoring K. Singh 2026-02-07
Skip Manual Drafting

Generate a Postmortem Report from a Video

Record a walkthrough, training session, or process demonstration. Docsie AI turns it into structured documentation using this template as the starting framework.

Use the template manually, or let Docsie generate the first draft from source footage.

DOCX, PDF, and Markdown downloads
Works with process and training videos

Template FAQ

Postmortem Report FAQ

Common questions about using and generating a postmortem Report.

Using This Template

Q: What is a postmortem Report?

A: A postmortem Report is a structured document for incident analysis with root cause and prevention.

Q: Can I download this postmortem Report as Word or PDF?

A: Yes. This page includes free downloads in DOCX, PDF, and Markdown formats so you can edit, share, or import the template into your documentation system.

Q: Can Docsie generate this from a video?

A: Yes. Upload a process walkthrough, training recording, or screen capture to Docsie, then use this template structure to generate a first draft automatically.